Novell 
GroupWise. 


6.5 


www.novell.com 


| TROUBLESHOOTING 3: MESSAGE FLOW 
February 28, 2005 AND DIRECTORY STRUCTURE 


Novell. 


Legal Notices 


Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express 
or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to 
make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. 


Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties 
of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, 
at any time, without any obligation to notify any person or entity of such changes. 


You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export 
regulations or the laws of the country in which you reside. 


Copyright © 1993-2005 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or 
transmitted without the express written consent of the publisher. 


Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without 
limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.novell.com/company/legal/patents/ and 
one or more additional patents or pending patent applications in the U.S. and in other countries. 


Novell, Inc. 

404 Wyman Street, Suite 500 
Waltham, MA 02451 

U.S.A. 


www.novell.com 


GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 
February 28, 2005 


Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see 
www.novell.com/documentation. 


Novell Trademarks 


Novell is a registered trademark of Novell, Inc. in the United States and other countries. 
Novell is a registered trademark of Novell, Inc. in the United States and other countries. 
NetWare is a registered trademark of Novell, Inc. in the United States and other countries. 
GroupWise is a registered trademark of Novell, Inc. in the United States and other countries. 
NDS is a registered trademark of Novell, Inc. in the United States and other countries. 

NLM is a trademark of Novell, Inc. 

QuickFinder is a trademark of Novell, Inc. 


Third-Party Trademarks 


All third-party trademarks are the property of their respective owners. 


Contents 


About This Guide 


Part I 


1 Message Delivery in the Local Post Office 
Access Mode: Client/Server 


2 Message Delivery to a Different Post Office 
TCP/IP Link Open: Transfer between Post Offices Successful 
TCP/IP Link Closed: Transfer between Post Offices Delayed 
Mapped/UNC Link Open: Transfer between Post Offices Successful 
Mapped/UNC Link Closed: Transfer between Post Offices Delayed 


3 Message Delivery to a Different Domain 
TCP/IP Link Open: Transfer between Domains Successful 
TCP/IP Link Closed: Transfer between Domains Delayed 
Mapped/UNC Link Open: Transfer between Domains Successful 
Mapped/UNC Link Closed: Transfer between Domains Delayed 
Alternate Link Configuration: Transfer Pull 


4 Message Delivery to and from the Internet 
Message Transfer from GroupWise to the Internet 
Message Transfer from the Internet to GroupWise 


5 Message Delivery to and from GroupWise Remote 
Mapped/UNC Link for "Hit the Road" 
Modem Link to the Remote User through the Async Gateway 


6 Administrative Database Update 
TCP/IP Link between the Domain and the Post Office 
Mapped/UNC Link between the Domain and the Post Office 


Part Il 


7 Message Transfer/Storage Directories 
Domain Directory 


Message Flow Diagrams 


Directory Structure Diagrams 


domain directory 


wpcsin directory... o... o... 


wptools directory 
wpgate directory 
wpcsout directory 


mitaname file> sinsin a ae eek ra Vas Gs Ge PS 


wpdomain.db file 
wpdomain.dc file 


wphostdc file . . ........... 0... ....... 
QWdOMAC filesi oidor e AR SAS Re eS 
gwpo.dc file... ........... 0... o... .... 


Contents 5 


agentinstallitht':. 0.6 24 bb be SE Seb eA Eee bE Ree RA EEE dd cds a 64 


Post Office: Directory: aieia eae ke A ah we a e Bt a Ok Bk ee Re ke ting e a E 64 
post-office-directOry......00 ee Ge ee a ee ee a ee ea ea eee ee 66 
WPCSINGINECIORY: g-er iaa Ree RS Osco seek Be ha AA oy gies AO ae hard Se 66 
dWdAMS:d irector. -s-s ee oS Gea eee BEA A oS ee Eee Be a AE a tae! bok a 68 
OIMSG:dIFECIOly 2.5 We wea Se eke ee ea i Be ee RAE eR Ra a a eee BE a 69 
ofuser directory Sa: hee is he ek Real ee Bee Pe als Soe ee a ee Se Se ee 70 
offiles directory: A A e ee PP EEE OS eS 71 
OIVIEWS: directory Gato nc a wt eee A eee ee a ot De Oe eo ea ak 71 
OIWOFKAIBCÍONY e et ek Boo ek a ek Rd a See ee Rte Bh A Ue PU ek A Ok es A es aN 71 
Ofdirect directory: t oie a i et ere A Se E ele Be 2 pe ee Sse 72 
WPCSOULCINECIOLY vs foe aoe ee Ain A oe BOE Gees BAe es 72 
Wphostdb file> 2 -s.e ata t ok lr tee a ee te LG ee eee Be a ee 75 
OWpO-dCuTIle s i Ale eA oO SR Re ee hid, BS eee ee A Eo eh ee be Re Rt BA 75 
ngwguard:db file- e ccoo Se Bea Soe es eee Oe ee Pe ee Oe ee te i 75 
ngwgüardide Mess sr asa ee hee ee Peps ea pen e Gee age Oe AP Be ee oe A en ee aE ne es ee eS 75 
ngwowiard. fk files. ac ele ae Re ae p ROR be ee ek oe a ae eke ee 75 
NQOWOWASrGAMNANG: Senasa Bie te ob ga ek Ba eA eke e ae fe Se, ele A a kB oe 76 
NQWCHECKIGD: 3 sf ace ee ed ey a kts, Se eee ER ae ele te Ee et QO Be a a o E e 76 
agentinstall:txt) lt E a ti Ane Pe eet Perk hae aad © bed BS eee TE SSE a Bed ots 76 

MTA Local Queue Directory. io mei p by 2 ae eR ke ae a ee Poe 76 
mslocáldirectoy ¿06 eo Se Ra ek ee ee ee A ek alee Se ee ee a 77 
MSGIOG CIKECIORY se oi ee eke oe A She cee BE Sed AE SS. eS ee ee Ze tnd Wh 77 
OWINProg directory meri as ea Bk Seg A We ee et A ee ee ee p ee POS Oa eS 78 
mshold: directory’: as. qt ase eae nara ee aad ge ee Samo Rates Gla on eek sede at a a Gee eG 78 
domains directory” <2. eae soe Bn nse OM i et ene a A Sse Boe oe Ee Pk e te aos a 78 
POSEXCIFECIONIES as See oe ee A et ee eS ee eee ba 78 
gatewayXx. directories’... aos 4 4 e Re oe ed hh ho ae Re eR ne a ee WR EMRE cs Bei es 78 
GomainxX directores: sop aue wy) aoa ee Be ee es a oe Bye day eR ga Ree ak BG A ASG see 79 
OMC AOS ta Bs ok Ra ee, ab ae ele eRe Ek Ra Al noe be ee E a A 79 
mtaname files: si soe owe ee A E eo ae AA AA ee oe GE Sor ae ie ee 79 
QWvsscani directory 0 doc a ch oy, & ate E ee AP Be Ae wR A be ae eee Sas ee eS 79 
mtaconv directory si sarees ae wat oP A A eo AA Gee eda eo eke es 79 

Internet Agent Queue Directory s e see ele e a BO ae a ee ee Be 80 
domain\wpgate\gwia directory . . . 2. a a a 81 
gwia directory os 245... gi ay wey SR Ae ee Gee Sho as ya Seog oe Bey ee E e he tk Bo o E ae 84 

WebAccess Agent Queue Directory... 2... aa a a a 86 
domain\wpgate\webac65a directory... 6. a a 86 
Q00.pre: directo Vo occ ee Be Re ek ES eS OE GP ee EE Ee ee Ea 86 
WPCSIN GIRECIOLY: % ooo ae Ra, O he EARS BOAR Ae ee eee ee a de EE RN eS: 87 
WPCsout directory oca putear E E oes ahd a A a Pe ee a ee e 87 
Qwhold:directory’ +... man's Ok He a Sek Reece Bo ROA AE, O e ee aoe ae 87 
Qwprob:directonys fs ewe A a ee a Re oe ee aoe 87 
TIES :CINECIONY.2 50 aes oe Bk Re ee oe Sh ee B i ee E o Be e AE 87 
template: directory” acapara Wa) a ip ae es ee aa Eon eae leak e oR a Phan es 87 
commagrcig Mex uta ae AN a he ek Ried, Oe Re Oe Rei hoe ee A ed se a a 87 
COMINNCIG MIG” 2 aoe goon By E et ae ee AE a ye a ee ae eS RA 88 
mimetype:cig file". <a fk a oe al ae oe ok ee a es Pale A Sa de EATE eS ow Bed 88 
gweache:db file: acordas e ea Oke Sek Bok A be ae A ee be el ke Ge | 88 
OWAc: AB TS": gee Sak hn ok KAO a A Ree e Se eh ais e KOA eR A ok AR RR eee ie 88 
QWac:de file: z maius e e See aes Bae Re ea a oe ae ee Boe ee aS 88 

Caching: Mailbox Directoy a: a ci ee Ge ee a aie Bee he E wea ek ae a A 89 
\novel\groupwise\gwxxxxxx directory . . . ooa a 89 
rofdata directo nonesa er Be ae i oe Be ES Rela ed ok hoe el eee Bok 4 90 
WPCSIN.GIFEGIOFY i: eos soe ee ee RR A OE a ee Pa e ee ep eae E R 92 


GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 


wpcsoutiofs:directory.... a o irracional aod 92 


wpgwsend directory... osis ai ok a A WR ede ba Be Ee PO Aa CR ee eu ee aS 92 
WpgWrecv directory’ i 2 aot 6 eo ee wore A a ee Es ee Ge al 93 
Remote: Mailbox-Directory: poses ani is A rre oe ae Se eae Bye ee Ae oe es eR ee ake Ade st See 93 
remote. mailbox. direCtOry:. s tt. sore nese A A ne RA alee a Ee a an 93 
WPCSIN:CIFECIORY eo cae i de Be a © ab lence eens Bh hale eh bo ee ae Ste Bb Els 94 
rofdata: directory. de ote ae A A TA Be ee Ge TA E A A a 94 
Wpgwsend directory: sy tes Gels Se a et be ae rei ee ee ik a ERE Re ES ee ak id 95 
WPOQWIeCV-dIFECIOLY uaap e EA mek EUR ow pe SOR A ee ek Sos AA 96 
Wpcsoutlofs:direciory:: sir sk RA A Re Pe Ra OR ee Ee Ee ea EO Pe oe ta 96 
Agent Installation Directories 97 
GroupWise Agent Installation (POA and MTA). ............ 97 
NetWare Installation Directory: ariei wae a ee ee ee a A e A a E a a at 97 
Linux Installation Directory . ansan a eoe e o a a a ee a ee 100 
Windows Installation Directory . 2... 105 
Internet Agent Installation . .. . oaoa aaa ee 107 
NetWare Installation Directory ............... d aa E a E AE a a aE E e a e D O a A aa 107 
Linux Installation Directory ............ a a a a e aa A h a E a Da e Ap p aa 109 
Windows Installation Directory...) aaa 112 
WebAccess Agent Installation . . . 1... o... 113 
NetWare Installation Directory ............... a 113 
Linux Installation Directory . . . 2. aa a 115 
Windows Installation Directory . . . o ooa 120 
Monitor Agent Installation. . . oaa ee 123 
kinux Installátiori Difectory: ecs o E ee ae ae oe AT ae AR GRO aa a ee 123 
Windows Installation Directory .. 2... 125 
Apache/Tomcat installation: x. s a-e A eae ee Be Bk Ee ee ae Pe ee ee BR ES 127 
NetWare Installation Directory . ............. ee 127 
Linux Installation DIEHO 2.4: 000 26k Ye E ee ig A Oe ER Pee A 133 
Software Distribution Directory 137 
NetWare/Windows Software Distribution Directory... . 2... 2. ..o e... o... 137 
\grpwise\software directory ........ a a a 138 
agents directory? A al caves e ken he hee a ee ee Be eee eee A parih 138 
domain directory 6226 24 ba Oa Yaw be pe Pe ae be a GE Pale ba ew ee Pa a ee ho 139 
POSICION fui een EA Siang A Se Se ee BA es Been AS GL 140 
client directory... ok ona o e hd ee bow bee PPh Ee ad ee hee be dae ES 141 
OfvieWS-dIreClory ve u en ee Sk ae A Ot ee Se et te ek ee tle se Dae 141 
ZEN directory “a eee cee ee oe ee PASE ORS he A ee eae be ee Paes eb ee wae es oe Be 142 
AadmiIn:directOny: 2 sc. 2S eh es A ig Pe ONS BONS SRE OS Be RE SAL Beck 142 
internet directory .. . . 2. a 142 
license. directory s 208 a Sa avn e ete Pea Se eevee es AS a RE ALD ES Sake 143 
common: directory... 26.4 e eae eC DG ae eh Re RPS Se ee OE Poe bbe ew eb ache ba 143 
docs directo... esd e RE ee Soe Geeta e Gl Se ke ee ete SAR ca 143 
Linux Software Distribution Directory. . . . oaoa aa a a 143 
/opt/novell/groupwise/software directory . . . o.oo aaa a 145 
agents directory) erre a at A ee bE AA A we yl 146 
domainidirectony” > ssri Ahk eee OS Re BE A ER ee OR SALES eh ae Bg ee ee E EA Bark 146 
¡AAA 147 
cllentdirectOry.. 4 lat e eck eth bo Se al Aa tee es ds oe ee a e at 148 
ofviews directory. cer eae ak Ba Ca ad bake RG ee ea aE A ba ew eh ae ha 148 
admin directo tyes ied. dot os wh ee We Nk de Ao we Geta aes, os Se ee be ow A AA CS Se 148 
internet directory soo 02...) or kb ee bee ee eA eee hee be de es 149 
license: directory: ne et A et ees oor Ee eee ds Greek eb ee oe 151 
docs directory vsr anr ina pa Dee Pe Bee A A ee ere ek bP eee aa 151 


Contents 7 


gwinst.difectOry’.. se Bp ba di bbe babe e ba Eee ee eh oe eae 151 


10 GroupWise Client Installation Directories 153 
WindowsClient. sor 2: Rin ioe bk RE EE a E A EL EG a Ee BOR Bd 153 
C:\novell\GrouPWiS@: cusco o Re Pe a a OE Se eee eee PA ee ee a eS 154 
OFPWISE ExXe TIC <3. Sow o do He kh Beek Pao a Oe e QE ee A eek Be i Ed ales, Sar eee BA ew PES 154 
QWwiip:exe file:., ez qm s oes Ao tA o Be aa eae ee ee Oe eee get ale ths oe 154 
notifyexerfile::. 3.24 A a a Bk le OA ES ok ER E SA E AE e es Foe SE hk ea ee eee ae 154 
addrbook:exe files. og as hae te Sk ee dor ee ee ae es ee ES 154 
gwecheck: EXE filers cst a is ee deg i Ste a Ree te ee ek nk he ae Ged Sk 154 
hirsetuprexe files: scree Od RAS 2s e wee ee do aS ee ee eee EO uate Bade a 154 
OWIMpexe:exe MO is e Se Eee we PAE A Re ee ae eee Ea E 155 
gwimailio:exe file cod x. ae a tek eh Gh Bd ag ee AE ee eS ee ee Ee Se 155 
gwrel0ad exe filet a ek Bek eS AES SE a oe Peek LS ae be oe ESS Ped 155 
Qwsyncrexe fle: z cine ee aes el dane Deel ete ae Ae Be fees pale la 155 
Ngwouardvde Mle: z 4 ae Bhs Ho ge ee Y Be Ro ee ee Rae Sk le E Se Ae ke os n 155 
Wo dle ici soe ern lt See ee A ee oe A he a ea ee 30 155 
SAMES HAE 4, oh. as a eee Ce a ee al od Oh Sot eal aa die Soo So en I es A eee 155 
“OCK MICS 3.5 id a & ON ae, Re eee a a A AA te, be Se ee Be A A a) a 155 
TOS 0 he A Oa RS ek Rag ee Alek re LE E ee Be ee ORAL 156 
CONOS 5 ic hog ee ey ak Re Gs Ee ie ee Se E a ee AA 156 
OIVIEWS. GIFECLONY Ss eeren oe A Pee PS A N aye ats EEE ES eR Be We end nig ea See oe Ge PES 156 
ppformsidirectOry s -s-c.rsrce ks eee Boe bh ee ae BOR oe Poe we Boe AAG ee bk a ee A 156 
Cross-Platform Clienton Linux .......... a a a a a a E RA E e E a EA A Are Tarn e E E RU E EE a 156 
/opt/novell/groupwise/client directory ........... a a 157 
bin:dinectory n; snsd eas ek ay e ds ees E a A ee Te ee Se ee i Gee a a ed a 157 

lib directory. 2.8 2 Ay pote a e ee A ARA BGR sa 157 

JE GITECIONY? ea fla wei Boe Sh og be de ok ee Bd Wee Ek hw ae Pb ee Ee A 158 
logs directory: = coc Th eR Shee E E Pe ae AA Pee ee ee ee 158 
Cross-Platform Client on Macintosh... 2... aaa L 158 
/Applications/GroupWise.app directory . . 2... a 159 
Contents directory a n Aua i n E a koe A Be See ede Ras ek Be ee, aa a ta E as 159 
MacOS directory; aiso a e oe eee le ee be Gb ee ee de 159 
Resources directory cis HAs eA we ee ee a BA Bn heb oe ink ae a BAe ae d 159 

lib dire@ctorys ul ey toe 2 thy) a ala ae da ae he AAA Ba Ea ASG Ye 159 
EVER Ao a mane on AS Ge Re eds Boe eee A ee ek ee a Oe E 159 


Part Ill Documentation Updates 


February 28, 2005 (GroupWise 6.5 SP4) . 2... a 161 
September 30} 2004... sora eae ee e Se ae eee ge Ae die aaa ea Pe 161 
September:30:2003 acs pune tees rr ala Oe ae Eee ese be aa Dee ee eee we 162 
July 16, 2003 (GroupWise 6.5SP1).. 2... 2. ee 162 


8 GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 


About This Guide 


This Novell® Group Wise? Troubleshooting 3 Guide provides diagrams to help you understand the 
structure and functioning of your GroupWise system. The guide is divided into the following 
sections: 


+ “Message Flow Diagrams” on page 11 
+ “Directory Structure Diagrams” on page 55 
Other sources of troubleshooting assistance include: 
+ Novell Support (http://support.novell.com) 
+ Novell Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
+ GroupWise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 


Additional Documentation 


For additional GroupWise documentation, see the following guides at the Novell GroupWise 6.5 
documentation Web site (http://www.novell.com/documentation/lg/gw65): 


¢ Installation Guide 

+ Administration Guide 

+ Multi-System Administration Guide 
+ Interoperability Guide 

+ GroupWise Client User Guides 


Documentation Updates 


For the most recent version of the GroupWise 6.5 Troubleshooting 3 Guide, visit the Novell 
GroupWise 6.5 documentation Web site (http://www.novell.com/documentation/lg/gw65). 


Documentation Conventions 


In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and 
items in a cross-reference path. 


A trademark symbol (™, z etc.) denotes a Novell trademark. An asterisk denotes a third-party 
trademark. 


User Comments 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comment feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 
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Message Flow Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand how 
messages travel between GroupWise® users and how administrative updates to GroupWise 


databases occur. 
+ “Message Delivery in the Local Post Office” on page 13 
+ “Message Delivery to a Different Post Office” on page 15 
+ “Message Delivery to a Different Domain” on page 27 


+ “Message Delivery to and from the Internet” on page 41 


+ “Message Delivery to and from GroupWise Remote” on page 45 


“Administrative Database Update” on page 51 


+ 
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Message Delivery in the Local Post Office 


The Group Wise 6 client functions optimally using client/server access to the post office. For an 
explanation of client/server access mode, see “Post Office Access Mode” in “Post Office Agent” 
in the GroupWise 6.5 Administration Guide. 


+ “Access Mode: Client/Server’ on page 13 


Access Mode: Client/Server 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
in the local post office when the client and POA communicate by way of TCP/IP. 


Stage Icon Description 

@ The user sends a message to recipients in the same post office. The 
Sender access mode setting for the post office is Client/Server Only. 

D The GroupWise client communicates with the POA by way of TCP/IP. 
Sender's 

GroupWise 

Client 
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Stage 


E 
POA for Local 
Post Office 


@ 
POA for Local 
Post Office 


D 
Recipient's 
GroupWise 
Client 


Recipient 


O 
Recipient's 
GroupWise Client 


@) 
POA for Local 
Post Office 


@ 
POA for Local 
Post Office 


Sender 


Description 


The POA receives the message from the GroupWise client and 
performs the following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned 
to the sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-76 
subdirectory assigned to the sender and creates pointers from the 
message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as 
attachments.) 


The POA also performs the following actions for the recipient: 


+ Creates a pointer in each recipient's user database (userxxx.db) to 
the message in the message database (msgnn.db) so the new 
message appears in the recipient's mailbox. 


+ Updates the message in the message database (msgnn.db) with a 
Delivered status for each recipient. 


The POA communicates to the GroupWise client by way of TCP/IP that 
a new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status to 
the POA by way of TCP/IP. 


The POA receives the Opened status from the GroupWise client and 
updates the message in the message database with the Opened status 
for each recipient who opens the message. 


The POA communicate the Opened status to the sender's GroupWise 
client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the 
GroupWise client, the message displays a status of Delivered for each 
recipient (and possibly Opened as well if the recipient has opened the 
message). 
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Message Delivery to a Different Post Office 


The MTA handles message transfer between post offices. 


+ 


+ 


+ 


+ 


“TCP/IP Link Open: Transfer between Post Offices Successful” on page 15 
“TCP/IP Link Closed: Transfer between Post Offices Delayed” on page 18 
“Mapped/UNC Link Open: Transfer between Post Offices Successful” on page 21 
“Mapped/UNC Link Closed: Transfer between Post Offices Delayed” on page 23 


For an explanation of link types and link protocols, see “Understanding Link Configuration” in 
“Domains” in the GroupWise 6.5 Administration Guide. 


TCP/IP Link Open: Transfer between Post Offices Successful 


This message flow diagram illustrates how a GroupWise® message travels from one user to 
another between post offices in the same domain when the TCP/IP link between the post office 
and the domain is open. 


DOMAINS 
0.7 


Stage Icon Description 
T The user sends a message to recipients in a different post office in the same 
Sender da domain. 


In this diagram, the access mode setting in the local post office is Client/ 
Server Only. 
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16 


Stage Icon 


Sender's 
GroupWise 
Client 


a = 
POA for 


Sender's POA 
Post Office 


@ 
POA for 


Sender's POA 
Post Office 


@ = 
MTA for 


Local Domain MTA 


@ x 
MTA for 


Local Domain MTA 


Description 


The GroupWise client communicates the message to the POA by way of 
TCP/IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the 
message to its attachments. (For database efficiency, messages and 
distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA by way of TCP/IP, 
and deletes the copy in the MTA input queue because the TCP/IP transfer to 
the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA were closed, see 
“TCP/IP Link Closed: Transfer between Post Offices Delayed” on page 18. 


The MTA receives the message and places it into the MTA "in progress" 
(gwinprog) queue. 


The MTA then communicates the message to the POA in the recipient's post 
office by way of TCP/IP. When the transmission is successful, the MTA 
deletes the message from the MTA "in progress" queue. 


If the TCP/IP link to the recipient's post office were closed, the message 
would be placed in the closed post office's holding queue in the MTA's 
mslocal directory for later transfer. The resulting message flow would be 
parallel to what occurs when a domain is closed. See “TCP/IP Link Closed: 
Transfer between Domains Delayed” on page 30 for a similar message flow 
that illustrates how messages to closed locations are handled. 
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Stage 


© 

POA for 
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® 
POA for Local 
Post Office 
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Client 


Recipient 
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Client 
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Post Office 
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MTA for 
Local Domain 


da 
MTA for 
Local Domain 


Icon 


MTA 


MTA 


Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding 
to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments. ) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP. When that transmission is successful, the copy in the MTA 
input queue is deleted. 


The POA communicates to the GroupWise client by way of TCP/IP that a 
new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status 
message to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA "in progress" (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender's post 
office by way of TCP/IP. 
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Stage Icon Description 


@ de The POA for the sender's post office updates the sender's message 

POA in database (msgnn.db) with the Delivered status information (and possibly 

Sender's POA Opened as well if the recipient has opened the message). 

Post Office 

® A, The POA communicates the status to the sender's GroupWise client by way 
we f TCP/IP. 

POA for Local G : 

Post Office POA 

a When the sender checks the sent items in his or her mailbox in the 

Sender pen GroupWise client, the message displays a status of Delivered for each 


recipient (and possibly Opened as well if the recipient has opened the 
message). 


TCP/IP Link Closed: Transfer between Post Offices Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the TCP/IP link between the post office and the 
domain is closed. 
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Stage Icon Description 
0) The user sends a message to recipients in a different post office in the same 
Sender pen domain. 
In this diagram, the access mode setting in the local post office is Client/ 
Server Only. 
@ The GroupWise client communicates the message to the POA by way of 
Sender's TCPIIP. 
GroupWise 
Client 
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Stage Icon 


@ = 
POA for 
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Sender's POA 
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MTA for 


Local Domain MTA 


(5) x 
MTA for 


Local Domain MTA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the 
message to its attachments. (For database efficiency, messages and 
distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then attempts to communicate the message to the MTA by way of 
TCP/IP, but the MTA does not respond. The POA leaves the copy of the 
message in the MTA input queue and periodically attempts to contact the 
MTA. When the MTA responds again, the POA communicates the message 
and deletes the copy in the MTA input queue after the TCP/IP transmission 
to the MTA is successful. 


The MTA receives the message and places it into the MTA "in progress" 
(gwinprog) queue. 


The MTA then communicates the message to the POA in the recipient's post 
office by way of TCP/IP. When the transmission is successful, the MTA 
deletes the message from the MTA "in progress" (gwinprog) queue. 


If the TCP/IP link to the recipient's post office were closed, the message 
would be placed in the closed post office's holding queue in the MTA's 
mslocal directory for later transfer. The resulting message flow would be 
parallel to what occurs when a domain is closed. For a similar message flow 
that illustrates how messages to closed locations are handled, see “TCP/IP 
Link Closed: Transfer between Domains Delayed” on page 30. 
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Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding 
to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP and when that transmission is successful, the copy in the MTA 
input queue is deleted. 


The POA communicates to the GroupWise client by way of TCP/IP that a 
new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status 
message to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA "in progress" (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender's 
post office by way of TCP/IP. 
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Stage Icon Description 


4 de The POA for the sender's post office updates the sender's message 

POA in database (msgnn.db) with the Delivered status information (and possibly 

Sender's POA Opened as well if the recipient has opened the message). 

Post Office 

® A, The POA communicates the Opened status to the sender's GroupWise client 
nti b f TCP/IP. 

POA for Local y Way © i 

Post Office POA 

a When the sender checks the sent items in his or her mailbox in the 

Sender pen GroupWise client, the message displays a status of Delivered for each 


recipient (and possibly Opened as well if the recipient has opened the 
message). 


Mapped/UNC Link Open: Transfer between Post Offices Successful 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the mapped or UNC link between the post office 
and the domain is open. 
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Stage Icon Description 
D The user sends a message to recipients in a different post office in the same 
Sender pen domain. 


In this diagram, the delivery mode setting for the local post office is Use App 
Thresholds and the threshold is not exceeded. 
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Stage Icon Description 


@ The GroupWise client performs the following actions for the sender: 
Sender's fs + Adds the message to the message database (msgnn.db) assigned to the 
GroupWise sender. 

Client 

+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 

+ Places attachments larger than 2 KB in the post_office\offiles\fd0-76 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 

+ Creates a copy of the message in the appropriate priority 0-7 subdirectory of 
the MTA input queue in the sender's post office. 

If client/server mode were in effect for the post office, these actions would be 

performed by the POA instead of the GroupWise client. See “Access Mode: 

Client/Server” on page 13. 

a For mapped and UNC links, the MTA scans its input queue in each post office 
MTA for for messages to process. You can control the rate at which the MTA scans its 
Local HTA input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Domain Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 

Guide. 

When it detects a new message, the MTA picks up the message from the 

sender's post office and transfers it to the MTA "in progress" (gwinprog) queue. 

From there the MTA transfers the message to the output queue in the recipient's 

post office. The MTA output queue is the input queue for the POA in the 

recipient's post office. 
@ The POA polls its input queue regularly. When it detects a new message, the 
POA for POA for the recipient's post office performs the following actions: 
Recipient's PQ + Adds the message to the message database (msgnn.db) corresponding to 
Post Office the one assigned to the sender. 

+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 

+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments. ) 

+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. 

5) The Notify component of the recipient's GroupWise client notifies the recipient 
Recipient's that a new message has arrived. 

GroupWise 

Client 

(5) Each recipient opens the message in the GroupWise client. 

Recipient pon 
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Stage Icon 


@ 
Recipient's 
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POA for 


Sender's POA 
Post Office 


e Ea 
Sender 


Description 


Each recipient's GroupWise client creates an Opened status message in the 
appropriate priority 0-7 subdirectory of the MTA input queue in the recipient's 
post office. 


For mapped and UNC links, the MTA scans its input queue for messages to 
process. You can control the rate at which the MTA scans its input queues. See 
“Adjusting MTA Polling of Input Queues in the Domain and Post Offices” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


When it detects the status message, the MTA picks it up from the recipient's 
post office and transfers it to the MTA "in progress" (gwinprog) queue. From 
there the MTA transfers the message to the output queue in the sender's post 
office. The MTA output queue is the input queue for the POA in the sender's 
post office. 


The POA for the sender's post office updates the sender's message database 
(MSGnn.DB) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 


Mapped/UNC Link Closed: Transfer between Post Offices Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the mapped or UNC link between the post office 
and the domain is closed. 
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Stage Icon 


D 
Sender 


Sender's 
GroupWise 
Client 


© 
MTA for 


Local Domain MTA 


Description 


The user sends a message to recipients in a different post office in the 
same domain. 


In this diagram, the delivery mode setting for the local post office is Use 
App Thresholds and the threshold is not exceeded. 


The GroupWise client performs the following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to 
the sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the 
message to its attachments. (For database efficiency, messages and 
distribution lists larger than 2 KB are also handled as attachments. ) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office. 


If client/server mode were in effect for the post office, these actions would 
be performed by the POA instead of the GroupWise client. See “Access 
Mode: Client/Server” on page 13. 


For mapped and UNC links, the MTA scans its input queue in each post 
office for messages to process. You can control the rate at which the MTA 
scans its input queues. See “Adjusting MTA Polling of Input Queues in the 
Domain and Post Offices” in “Message Transfer Agent” in the GroupWise 
6.5 Administration Guide. 


When it detects a new message, the MTA picks up the message from the 
sender's post office and transfers it to the MTA "in progress" (gwinprog) 
queue. However, because the recipient's post office is closed, the MTA 
cannot complete the delivery. Therefore, the MTA stores the message in 
the holding queue for the recipient's post office in the mslocal directory. 


When the recipient's post office is open again, the MTA transfers the 
delayed message from the post office holding queue to the MTA output 
queue in the recipient's post office. The MTA output queue is the input 
queue for the POA in the recipient's post office. 
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Description 


The POA polls its input queue regularly. When it detects a new message, 
the POA for the recipient's post office performs the following actions: 


+ Adds the message to the message database (msgnn.db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the 
new message appears in the recipient's mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and 
creates pointers from the message to its attachments. (For database 
efficiency, messages and distribution lists larger than 2 KB are also 
handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client creates an Opened status message in 
the appropriate priority 0-7 subdirectory of the MTA input queue in the 
recipient's post office. 


For mapped and UNC links, the MTA scans its input queue in each post 
office for messages to process. You can control the rate at which the MTA 
scans its input queues. See “Adjusting MTA Polling of Input Queues in the 
Domain and Post Offices” in “Message Transfer Agent” in the GroupWise 
6.5 Administration Guide. 


When it detects the status message, the MTA picks it up from the 
sender's post office and transfers it to the MTA "in progress" (gwinprog) 
queue. Because the sender's post office is open, the MTA can 
immediately transfer the message to the output queue in the sender's 
post office. The MTA output queue is the input queue for the POA in the 
sender's post office. 


The POA for the sender's post office updates the sender's message 
database (msgnn.db) with the Delivered status information (and possibly 
Opened as well if the recipient has opened the message). 


When the sender checks the sent items in his or her mailbox in the 
GroupWise client, the message displays a status of Delivered for each 
recipient (and possibly Opened as well if the recipient has opened the 
message). 
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Message Delivery to a Different Domain 


The MTA handles message transfer between domains. 
+ “TCP/IP Link Open: Transfer between Domains Successful” on page 27 
+ “TCP/IP Link Closed: Transfer between Domains Delayed” on page 30 
+ “Mapped/UNC Link Open: Transfer between Domains Successful” on page 33 
+ “Mapped/UNC Link Closed: Transfer between Domains Delayed” on page 36 
+ “Alternate Link Configuration: Transfer Pull” on page 38 


For an explanation of link types and link protocols, see “Understanding Link Configuration” in 
“Domains” in the GroupWise 6.5 Administration Guide. 


TCP/IP Link Open: Transfer between Domains Successful 


This message flow diagram illustrates how a GroupWise® message travels from one user to 
another when the domains are connected by a TCP/IP link and the link is open. 


Stage Icon Description 
TD The user sends a message to recipients in a post office in a different domain. 
Sender pen 


In this diagram, the access mode setting for the local post office is Client/Server 
Only. 
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Description 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory of 
the MTA input queue in the sender's post office, in case the TCP/IP link to 
the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender's domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA were closed, see “TCP/ 
IP Link Closed: Transfer between Post Offices Delayed” on page 18. 


The MTA for the sender's domain receives the message and places it into the 
MTA "in progress" (gwinprog) queue. 


The MTA for the sender's domain then communicates the message to the MTA 
for the recipient's domain by way of TCP/IP. 


If the TCP/IP link to the recipient's domain were closed, the message would be 
placed in the closed domain's holding queue in the MTA's mslocal directory for 
later transfer. See “TCP/IP Link Closed: Transfer between Domains Delayed” 
on page 30. 


The MTA for the recipient's domain receives the message and places it into the 
MTA "in progress" (gwinprog) queue. 


The MTA for the recipient's domain then communicates the message to the 
POA in the recipient's post office by way of TCP/IP. 
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Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding to 
the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way of 
TCP/IP and when that transmission is successful, the copy in the MTA input 
queue is deleted. 


The POA for the recipient's post office communicates to the GroupWise client 
by way of TCP/IP that a new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message 
to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to the 
MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain places the status message into the MTA "in 
progress" (gwinprog) queue. 


The MTA for the recipient's domain communicates the status message to the 
MTA for the sender's domain by way of TCP/IP. 
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Stage Icon Description 


T The MTA for the sender's domain places the status message into the MTA "in 
MTA for ZP progress" (gwinprog) queue. 

Sender's HTA 

Domain 

da The MTA for the sender's domain communicates the status message to the 
MTA for POA for the sender's post office by way of TCP/IP. 

Sender's HTA 

Domain 

ME) The POA for the sender's post office updates the sender's message database 
POA for Ge (MSGnn.DB) with the Delivered status information (and possibly Opened as 
Sender's POA well if the recipient has opened the message). 

Post Office 

en The POA for the sender's post office communicates the status to the sender's 
POA for GroupWise client by way of TCP/IP. 

Sender's POA 

Post Office 

@ When the sender checks the sent items in his or her mailbox in the GroupWise 
Sender da client, the message displays a status of Delivered for each recipient (and 


possibly Opened as well if the recipient has opened the message). 


TCP/IP Link Closed: Transfer between Domains Delayed 


30 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a TCP/IP link and the link is closed. 
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Description 


The user sends a message to recipients in a post office in a different domain. 


In this diagram, the access mode setting for the local post office is Client/ 
Server Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the MTA input queue in the sender's post office, in case the TCP/IP link 
to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender's domain 
by way of TCP/IP, and deletes the copy in the MTA input queue because the 
TCP/IP transfer to the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA were closed, see 
“TCP/IP Link Closed: Transfer between Post Offices Delayed” on page 18. 


The MTA for the sender's domain receives the message and places it into the 
MTA "in progress" (gwinprog) queue. 


The MTA for the sender's domain then attempts to communicate the message 
to the MTA for the recipient's domain by way of TCP/IP, but the recipient MTA 
does not respond. Therefore, the MTA stores the message in its holding queue 
for the recipient's domain in the mshold directory. 


When the MTA in the recipient's domain responds again, the MTA for the 
sender's domain transfers the delayed message from the domain holding 
queue to the MTA in the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain receives the message and places it into 
the MTA "in progress" (gwinprog) queue. 


The MTA for the recipient's domain then communicates the message to the 
POA in the recipient's post office by way of TCP/IP. 
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When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding to 
the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way of 
TCP/IP and when that transmission is successful, the copy the MTA input 
queue is deleted. 


The POA for the recipient's post office communicates to the GroupWise client 
by way of TCP/IP that a new message has arrived. 


The Notify component ofthe recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message 
to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain places the status message into the "in 
progress” (gwinprog) queue. 


The MTA for the recipient's domain communicates the status message to the 
MTA for the sender's domain by way of TCP/IP. 
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The MTA for the sender's domain places the status message into the MTA "in 
progress" (gwinprog) queue. 


The MTA for the sender's domain communicates the status message to the 
POA for the sender's post office by way of TCP/IP. 


The POA for the sender's post office updates the sender's message database 
(msgnn.db) with the Delivered status information (and possibly Opened as well 
if the recipient has opened the message). 


The POA for the sender's post office communicates the status to the sender's 
GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 


Mapped/UNC Link Open: Transfer between Domains Successful 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a mapped or UNC link and the link is open. 
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Description 


The user sends a message to recipients in a post office in a different domain. 


In this diagram, the delivery mode setting in the local post office is Use App 
Thresholds and the threshold is not exceeded. 


The GroupWise client performs the following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory of 
the MTA input queue in the sender's post office. 


If client/server mode were in effect for the post office, these actions would be 
performed by the POA instead of the GroupWise client. See “Access Mode: 
Client/Server” on page 13. 


For mapped and UNC links, the MTA scans its input queue in each post office 
for messages to process. You can control the rate at which the MTA scans its 
input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


When it detects a new message, the MTA picks up the message from the 
sender's post office and transfers it to the MTA "in progress" (gwinprog) queue. 
From there, the MTA in the sender's domain transfers the message to the 
output queue in the recipient's domain. 


The MTA in the recipient's domain also polls its input queue. When it detects a 
new message, the MTA in the recipient's domain picks up the message from its 
domain input queue and transfers it to the MTA "in progress" (gwinprog) queue. 
From there, the MTA in the recipient's domain transfers it to the output queue in 
the recipient's post office. The MTA output queue is the input queue for the POA 
in the recipient's post office. 
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Description 


The POA polls its input queue regularly. When it detects a new message, the 
POA for the recipient's post office performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding to 
the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client creates an Opened status message in the 
appropriate priority 0-7 subdirectory of the MTA input queue in the recipient's 
post office. 


For mapped and UNC links, the MTA scans its input queue in each post office 
for messages to process. You can control the rate at which the MTA scans its 
input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


When it detects the status message, the MTA picks it up from the recipient's 
post office and transfers it to the MTA "in progress" (gwinprog) queue. From 
there, the MTA in the recipient's domain transfers the status message to the 
output queue in the sender's domain. 


The MTA in the sender's domain also polls its domain input queues. When it 
detects the status message, the MTA in the sender's domain picks it up and 
transfers it to the output queue in the sender's post office. The MTA output 
queue is the input queue for the POA in the sender's post office. 


The POA in the sender's post office updates the sender's message database 
(MSGnn.DB) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 
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Mapped/UNC Link Closed: Transfer between Domains Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a mapped or UNC link and the link is closed. 
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T) The user sends a message to recipients in a post office in a different domain. 
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In this diagram, the delivery mode setting for the local post office is Use App 
Thresholds and the threshold is not exceeded. 


D The GroupWise client performs the following actions for the sender: 
Sender's E + Adds the message to the message database (msgnn.db) assigned to the 
GroupWise sender. 

Client 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory of 
the sender's MTA input queue. 


If client/server mode were in effect for the post office, these actions would be 
performed by the POA instead of the GroupWise client. See “Access Mode: 
Client/Server” on page 13. 


36 GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 


Stage Icon 


El = 
MTA for 


Sender's HTA 


Domain 


Va in 


Recipient's MTA 
Domain 


i in 


Recipients POA 
Post Office 


® 
Recipient's 
GroupWise 
Client 


Recipient 


© 
Recipient's 
GroupWise 
Client 


Description 


For mapped and UNC links, the MTA scans its input queue in each post office 
for messages to process. You can control the rate at which the MTA scans its 
input queues.See “Adjusting MTA Polling of Input Queues in the Domain and 
Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


When it detects a new message, the MTA picks up the message from the 
sender's post office and transfers it to the MTA "in progress" (gwinprog) queue. 
However, because the recipient's domain is closed, the MTA in the sender's 
domain cannot complete the delivery. Therefore, the MTA in the sender's 
domain stores the message in its holding queue for the recipient's domain in the 
mslocal directory. From there, the MTA in the sender's domain transfers the 
message to the output queue in the recipient's domain. 


When the recipient's domain is open again, the MTA in the sender's domain 
transfers the delayed message from the domain holding queue to the MTA 
output queue in the recipient's domain. 


The MTA in the recipient's domain also polls its input queue. When it detects a 
new message, the MTA in the recipient's domain picks up the message from its 
domain input queue and transfers it to the MTA "in progress" (gwinprog) queue. 
From there, the MTA transfers the message to the output queue in the 
recipient's post office. The MTA output queue is the input queue for the POA in 
the recipient's post office. 


The POA polls its input queue regularly. When it detects a new message, the 
POA in the recipient's post office performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding to 
the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-76 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client creates an Opened status message in the 
appropriate priority 0-7 subdirectory of the MTA input queue in the recipient's 
post office. 
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@ For mapped and UNC links, the MTA scans its input queue in each post office 
MTA for for messages to process. You can control the rate at which the MTA scans its 
Recipient's MTA input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Domain Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 
When it detects the status message, the MTA picks it up from the recipient's 
post office and transfers it to the MTA "in progress" (gwinprog) queue. From 
there, the MTA in the recipient's domain transfers the status message to the 
output queue in the sender's domain. 
Aù de The MTA in the sender's domain also polls its domain input queues. When it 
MTA for detects the status message, the MTA in the sender's domain picks it up and 
Sender's HTA transfers it to its output queue in the sender's post office. The MTA output queue 
Domain is the input queue for the POA in the sender's post office. 
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Sender's POR if the recipient has opened the message). 
Post Office 
RE) When the sender checks the sent items in his or her mailbox in the GroupWise 
Sender da client, the message displays a status of Delivered for each recipient (and 


possibly Opened as well if the recipient has opened the message). 


Alternate Link Configuration: Transfer Pull 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a transfer pull configuration. 
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Description 
The user sends a message to recipients in a post office in a different domain. 


In this diagram, the delivery mode setting for the local post office is Use App 
Thresholds and the threshold is not exceeded. 


The GroupWise client performs the following actions for the sender: 


+ Adds the message to the message database (msgnn.db) assigned to the 
sender. 


+ Creates a pointer in the sender's user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. (For database efficiency, messages and distribution lists 
larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory of 
the MTA input queue in the sender's post office. 


If client/server mode were in effect for the post office, these actions would be 
performed by the POA instead of the GroupWise client. See “Access Mode: 
Client/Server” on page 13. 


For mapped and UNC links, the MTA scans its input queue in each post office 
for messages to process. You can control the rate at which the MTA scans its 
input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


When it detects a new message, the MTA picks up the message from the 
sender's post office and transfers it to the MTA "in progress" (gwinprog) queue. 
From there, the MTA for the sender's domain would normally transfer the 
message to the output queue in the recipient's domain. However, in this transfer 
pull configuration, the MTA for the sender's domain does not have access to the 
recipient's domain. Therefore, the MTA for the sender's domain transfers the 
message into the appropriate priority 0-7 subdirectory in the transfer directory 
in its own domain. It is now the job of the MTA for the recipient's domain to pick 
up (or 'pull') the message from the sender's domain to the recipient's domain. 


See “Using a Transfer Pull Configuration” in “Message Transfer Agent” in the 
GroupWise 6.5 Administration Guide. 


The MTA for the recipient's domain polls its input queue in the local domain and 
any transfer directories in other domains. The transfer pull configuration is the 
only situation where an MTA scans directories outside its own directory 
structure. 


When it detects a new message in a transfer directory of another domain, the 
MTA picks up (or "pulls") the message from the other domain and transfers it to 
the MTA "in progress" (gwinprog) queue. From there, the MTA for the 
recipient's domain transfers the message to the output queue in the recipient's 
post office. The MTA output queue is the input queue for the POA in the 
recipient's post office. 
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Description 


The POA polls its input queue regularly. When it detects a new message, the 
POA in the recipient's post office performs the following actions: 


+ Adds the message to the message database (msgnn.db) corresponding to 
the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory corresponding to the one assigned to the sender and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. 


The Notify component of the recipient's GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client creates an Opened status message in the 
appropriate priority 0-7 subdirectory of the MTA input queue in the recipient's 
post office. 


For mapped and UNC links, the MTA scans its input queue in each post office 
for messages to process. You can control the rate at which the MTA scans its 
input queues. See “Adjusting MTA Polling of Input Queues in the Domain and 
Post Offices” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


When it detects the status message, the MTA picks it up from the recipient's 
post office and transfers it to the MTA "in progress" (gwinprog) queue. From 
there the MTA in the recipient's domain transfers the status message to the 
output queue in the sender's domain. 


The MTA in the sender's domain also polls its domain input queues. When it 
detects the status message, the MTA in the sender's domain picks it up and 
transfers it to its output queue in the sender's post office. The MTA output 
queue is the input queue for the POA in the sender's post office. 


The POA in the sender's post office updates the sender's message database 
(MSGnn.DB) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 
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Message Delivery to and from the Internet 


+ “Message Transfer from Group Wise to the Internet” on page 41 


+ “Message Transfer from the Internet to GroupWise” on page 43 


Message Transfer from GroupWise to the Internet 


The diagram below shows the flow of outbound messages through the GroupWise® directory 
structure to the Internet. 
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The GroupWise client performs the following actions for the sender: 


+ Adds the message to the message database (msgnn.db file) assigned to 
the sender. 


+ Creates a pointer in the sender’s user database (userxxx.db file) so the 
message appears in the sender's Out Box. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory assigned to the sender and creates pointers from the message 
to its attachments. 


+ Creates a copy of the message in the appropriate priority 0-7 subdirectory 
of the sender's MTA input queue. 


If client/server mode were in effect for the post office, these actions would be 
performed by the POA instead of the GroupWise client. See “Access Mode: 
Client/Server” on page 13. 


The MTA for the sender's domain polls its input queue as specified by Scan 


Cycle in Agent Settings in ConsoleOne®. When it detects a new message, the 
MTA recognizes that it must be sent through a gateway and places the 
message in its output queue in the program’s directory structure: 
domain\wpgate\gwia\wpcsout\a\0-7. 


The Internet Agent picks up the file in binary-encrypted format from the 
wpcsout\ia\0-7 directory and converts it. It UUencodes any attachments unless 
the Internet Agent is configured with the /mime switch to use MIME 
specifications or unless the sender specified the MIME foreign domain. 


If MIME is specified, the Internet Agent encodes the message attachments 
with the appropriate encoding scheme, as specified in the mimetype.cfg file. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the file in the wpgate\gwia\send directory. 


The Internet Agent processes the message in the domain\wpgate\gwia\send 
directory and sends the message to the destination host across the Internet. 


The Internet Agent creates a file, R*.*, that records the SMTP reply codes 
(error messages or transmission confirmation) in the wpgatelgwialresult 
directory. After the Internet Agent completes the transmission with the 
destination host, it moves the S file from the send directory to the result 
directory. 
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@ Gwia The Internet Agent analyzes the files in the result directory, comparing the 
Internet SMTP reply codes in the R file. 
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If the Internet Agent was successful at sending the message (meaning the R 
file had the 250 OK SMTP reply code), then the two files are deleted. The 
Internet Agent sends a Transferred status message to the sender’s Sent Items 
folder. 


If the R file has a temporary transmission error (meaning it has a 400-level 
SMTP reply code such as 450 Host Down), the Internet Agent moves the S file 
to the defer directory and re-queues the message to the send directory 
according to the Retry Schedule. At the end of the Retry Schedule, if the 
Internet Agent is still unsuccessful at transmitting the message, the Internet 
Agent moves the S file to the gwprob directory and deletes all the schedule 
files in the defer\work directory. The Internet Agent sends an Undeliverable 
status message to the sender’s Mailbox and Sent Items folder. 


If the R file has a fatal rather than a temporary error (meaning it has a 500-level 
SMTP reply code such as 550 Host Unknown), the Internet Agent sends an 
Undeliverable status message immediately to the sender’s Mailbox and Sent 
Items folder. The Internet Agent deletes the R file and moves the S file to the 
gwprob directory. 


Only the msgnn.db (not the userxxx.db) is updated when the Internet Agent 
sends a status message for the user’s Sent Items folder. 


Message Transfer from the Internet to GroupWise 


The diagram below shows the flow of inbound messages from the Internet through the Group Wise 
directory structure to the Group Wise recipient. 
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Gwia A Message is sent from an Internet user to a GroupWise user and the 
= Internet Agent places the message in the wpgate\gwia\receive directory. 


Gwia The Internet Agent polls the receive directory, converts the message to 
GroupWise format and places it in the wpgate\gwia\wpcsin\0-7 directory, 
where 0-7 is one of the priority directories from 0-7. The Internet Agent puts 
messages only in the 4 directory. 


de The Message Transfer Agent polls the domainwpgatelgwialwpesinWd0-7f 
Le directory and moves the file to the post_office\wpcsout\ofs\0-7 directory. 


MTA 


hy The POA polls its input queue regularly. When it detects a new message, 
the POA in the recipient's post office performs the following actions: 


POA + Adds the message to the message database (msgnn.db file) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db file), so the 
message appears in the recipient's Mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-76 
subdirectory corresponding to the one assigned to the sender and 
creates pointers from the message to its attachments. (For database 
efficiency, messages and recipient lists larger than 2 KB are also 
handled as attachments. ) 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


$ Each recipient opens the message in the GroupWise client. 
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Message Delivery to and from GroupWise 
Remote 


GroupWise® client users can still access information in their mailboxes even when not connected 
to the network. 


+ “Mapped/UNC Link for "Hit the Road"” on page 45 
+ “Modem Link to the Remote User through the Async Gateway” on page 47 


Mapped/UNC Link for "Hit the Road" 


This message flow diagram illustrates how a user who will be away from the network prepares to 
access GroupWise from a remote location. 
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User 


GroupWise 
Remote 


GroupWise 
Remote 


@ 

MTA for 
Remote 
User's 
Domain 


© 

POA for 
Remote 
User's 
Post Office 


® 

MTA for 
Remote 
User's 
Domain 


Icon 


HTA 


MTA 


Description 


The GroupWise user requests items from the master mailbox to be downloaded 
to the Remote mailbox in preparation for disconnecting from the master 
GroupWise system. For example, the user could be preparing a laptop 
computer for use away from the network using the Hit the Road feature of the 
GroupWise client. 


When the GroupWise Remote user sends a request for items from the master 
mailbox, GroupWise Remote places the request in the wpcsin\1 subdirectory of 
the remote input queue on the user's remote computer. 


When the GroupWise Remote user establishes a direct network connection 
between the remote computer and the master GroupWise system, the 
GroupWise client places the request into the priority 1 subdirectory of the MTA 
input queue (WPCSIN) in the post office to which the GroupWise Remote user 
has connected. The MTA then transfers the request to the post office where the 
GroupWise Remote user's master mailbox is located. 


If the GroupWise Remote user has connected directly to the post office where 
the master mailbox is located, GroupWise Remote places the request directly 
into the priority 1 subdirectory of the POA input queue (wpesoutlofs) in the post 
office, so processing by the MTA is not needed. 


For mapped and UNC links, the MTA for the GroupWise Remote user's domain 
scans its input queue in each post office for messages to process. You can 
control the rate at which the MTA scans its input queues. See “Adjusting MTA 
Polling of Input Queues in the Domain and Post Offices” in “Message Transfer 
Agent” in the GroupWise 6.5 Administration Guide. 


When it detects the new request from the GroupWise Remote user, the MTA 
picks it up from its domain input queue and transfers it to the post office where 
the GroupWise Remote user's master mailbox is located. The MTA output 
queue is the input queue for the POA in the post office where the GroupWise 
Remote user's master mailbox is located. 


The POA polls its input queue regularly. It quickly detects the new request from 
the GroupWise Remote user. 


When the GroupWise Remote user sends a request for items from the master 
mailbox, the POA performs the following actions: 


+ Gathers the requested items from the GroupWise Remote user's master 
mailbox (msgnn.db and userxxx.db). 


+ Gathers any attachments for requested items from the 
post_office\offiles\fd0-f6 subdirectory in the GroupWise Remote user's post 
office. 


+ Compiles the information into a response file and places it in the priority 1 
subdirectory of the MTA input queue (wpcsin) for return to the GroupWise 
Remote user. 


When the MTA in the GroupWise Remote user's domain detects the response 
for the GroupWise Remote user, the MTA picks it up from its post office input 
queue and transfers it to its output queue in the ofdirect directory in the post 
office where the GroupWise Remote user's master mailbox is located. The MTA 
output queue in the ofdirect directory is the input queue for the GroupWise client 
on the remote computer. 
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Stage Icon Description 


D The GroupWise client picks up the response in the post office and transfers it 

GroupWise to its input queue on the GroupWise Remote user's computer. 

Remote 

@ Taking the items from its input queue, the GroupWise client performs the 

GroupWise following actions for the GroupWise Remote user: 

Remote + Updates the GroupWise Remote message database (msg.db) with any 
items requested from the GroupWise Remote user's master mailbox. 

+ Creates pointers in the GroupWise Remote user database (user.db) so the 
messages gathered from the master mailbox appear in the user's 
GroupWise Remote mailbox. 

+ Places any requested attachments larger than 2 KB in the rofdata directory 
and creates pointers from the message to its attachments. (For database 
efficiency, messages and distribution lists larger than 2 KB are also handled 
as attachments.) 

The user's GroupWise Remote mailbox now contains current copies of 

requested items from the user's master mailbox. 

® The GroupWise user can now review current GroupWise mail after the 
Remote da connection to the master GroupWise system is no longer available. 
User 


Modem Link to the Remote User through the Async Gateway 


This message flow diagram illustrates how a GroupWise Remote user can access the master 
GroupWise system through the GroupWise Async Gateway. 
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Stage Icon 


D 
Remote 


User 


GroupWise 
Remote 


GroupWise 
Remote 


o: 
GroupWise 
Remote 
(Modem 
Connection) 


A 
Async | : 


Gateway 


pa 
Async | : 


Gateway 


Description 


The GroupWise user, who is not currently connected to the network, sends 
a message to another GroupWise user or creates a request for items from 
the master mailbox. 


This message flow diagram illustrates only the simplest case where the 
recipient is in the same post office as the GroupWise Remote user's master 
mailbox. If the GroupWise Remote user sends a message to a user in any 
other post office, the MTA would route the message to the appropriate 
destination. 


When the GroupWise Remote user sends a message to another GroupWise 
user, GroupWise Remote performs the following actions: 


+ Adds the message to the GroupWise Remote message database 
(msg.db) on the user's remote computer. 


+ Creates a pointer in the GroupWise Remote user database (user.db) so 
the message appears in the mailbox on the user's remote computer as a 
sent item. 


+ Places attachments larger than 2 KB in the rofdata directory and creates 
pointers from the message to its attachments on the user's remote 
computer. (For database efficiency, messages and distribution lists larger 
than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the wpcsin\1 subdirectory of the remote 
input queue on the user's remote computer. 


When the GroupWise Remote user sends a request for items from the 
master mailbox, GroupWise Remote places the request in the WPCSIN\1 
subdirectory of the remote input queue on the user's remote computer. 


When the user initiates the modem connection, the GroupWise client on the 
remote computer polls the wpcsin\1 subdirectory and compresses the 
outgoing messages and/or requests into a file. If the compressed file totals 
over 50 KB, additional compressed files are created. 


The GroupWise client next moves the compressed files into the wogwsend 
directory, then dials in to the gateway and logs in. 


After the login process is completed, GroupWise Remote transmits the 
compressed message/request file(s) across the modem connection to the 
system where the user's master mailbox is located. 


The GroupWise Async Gateway picks up the message/request files and 
decompresses them. 


The Async Gateway moves the message/request files to the MTA input 
queue. 
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Stage 


D 
MTA for 
Remote 
User's 
Domain 


O 

POA for 
Remote 
User's 
Post Office 


@ 
MTA in 
Remote 
User's 
Domain 


Icon 


MTA 


POA 


MTA 


Description 


For mapped and UNC links, the MTA for the GroupWise Remote user's 
domain scans its input queue for messages to process. You can control the 
rate at which the MTA scans its input queues. See “Adjusting MTA Polling of 
Input Queues in the Domain and Post Offices” in “Message Transfer Agent” 
in the GroupWise 6.5 Administration Guide. 


When it detects the new message or request from the GroupWise Remote 
user, the MTA picks it up from its domain input queue and transfers it to its 
output queue in the post office where the GroupWise Remote user's master 
mailbox is located. The MTA output queue is the input queue for the POA in 
the post office where the GroupWise Remote user's master mailbox is 
located. 


This message flow diagram illustrates only the simplest case where the 
recipient is in the same post office as the GroupWise Remote user's master 
mailbox. If the GroupWise Remote user sends a message to a user in any 
other post office, the MTA would route the message to the appropriate 
destination. 


The POA polls its input queue regularly. It quickly detects the new message 
or request from the GroupWise Remote user. 


When the GroupWise Remote user sends a message, the POA performs 
the following actions: 


+ Adds the message to the GroupWise Remote user's message database 
(msgnn.db). This updates the GroupWise Remote user's master mailbox. 


+ Creates a pointer in the recipient's user database (userxxx.db) so the new 
message appears in the recipient's mailbox and updates the notification 
information in the user database so the recipient can be notified of the 
message. 


+ Places attachments larger than 2 KB in the post_office\offiles\fd0-f6 
subdirectory in the GroupWise Remote user's post office and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments. ) 


+ Creates a "Delivered" status message in the priority 1 subdirectory of the 
GroupWise Remote user's MTA input queue (wpcsin). 


When the GroupWise Remote user sends a request for items from the 
master mailbox, GroupWise Remote performs the following actions: 


+ Gathers the requested items from the GroupWise Remote user's master 
mailbox (msgnn.db). 


+ Gathers any attachments for requested items from the 
post_office\offiles\fd0-f6 subdirectory in the GroupWise Remote user's 
post office. 


+ Compiles the information into a response file and places it in the priority 
1 subdirectory of the MTA input queue for return to the GroupWise 
Remote user. 


When the MTA in the GroupWise Remote user's domain detects the 
response for the GroupWise Remote user, the MTA picks it up from its post 
office input queue and transfers it to its output queue in the Async Gateway 
directory under wpgate in the GroupWise Remote user's domain. The MTA 
output queue in the Async Gateway directory is the input queue for the Async 
Gateway. 
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Stage 


Async 
Gateway 


Async 
Gateway 


a 

Async 
Gateway 
(Modem 
Connection) 


GroupWise 
Remote 


GroupWise 
Remote 


Remote 
User 


Icon 


a 


Description 


The Async Gateway picks up the response file and moves it to the priority 1 
subdirectory of its output queue. 


If the connection to the GroupWise Remote user is still active, the Async 
Gateway compresses the response files and moves them to the CMP 
directory. 


If the connection is no longer available, the response files wait in the 
connection_id\1 subdirectory until a new connection is established by the 
GroupWise Remote user. 


The Async Gateway transmits the response files through the modem 
connection to GroupWise Remote on the remote computer. 


The GroupWise client on the remote computer decompresses the response 
files and places them in its input queue on the GroupWise Remote user's 
computer. 


Taking the items from its input queue, the GroupWise client performs the 
following actions for the GroupWise Remote user: 


+ Updates the GroupWise Remote message database (msg.db) with any 
items requested from the GroupWise Remote user's master mailbox. 


+ Creates pointers in the GroupWise Remote user database (user.db) so 
the messages gathered from the master mailbox appear in the 
GroupWise Remote user's mailbox. 


+ Places any requested attachments larger than 2 KB in the rofdata 
directory and creates pointers from the message to its attachments. (For 
database efficiency, messages and distribution lists larger than 2 KB are 
also handled as attachments.) 


The user's Remote mailbox now contains current copies of requested items 
from the user's master mailbox, plus any messages received in the user's 
master mailbox from other GroupWise users. 


The GroupWise user can now review current GroupWise mail when the 
connection to the master GroupWise system is no longer available. 
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Administrative Database Update 


NetWare® Administrator and the agents handle database updates throughout the GroupWise? 
system. 


+ “TCP/IP Link between the Domain and the Post Office” on page 51 
+ “Mapped/UNC Link between the Domain and the Post Office” on page 521 


TCP/IP Link between the Domain and the Post Office 


This message flow diagram illustrates how an administrative message, such as a database update 
request, passes from ConsoleOne® to the agents so that databases are updated throughout the 
Group Wise system. In this diagram, the MTA transfers the administrative message to the POA by 
way of TCP/IP. 
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Stage Actor Action 


a The administrator uses GroupWise Administrator in ConsoleOne to add, 
GroupWise pen modify, or delete a GroupWise object in a single-domain, single-post office 
Administrator GroupWise system. 


An object could be a GroupWise user, resource, distribution list, post 
office, secondary domain, and so on. 
D EC ConsoleOne performs the following actions: 


ConsoleOne + Updates the domain database (wpdomain.db) to reflect the addition, 
modification, or deletion performed in GroupWise Administrator. 


+ Creates an administrative message in the priority 2 subdirectory of the 
domain's MTA input queue (wpcsin) to replicate the update. 


3) hy The MTA for the domain transfers the administrative message to the MTA 

MTA for "in progress" (gwinprog) queue. From there, the MTA communicates the 

Domain HTA administrative message to the POA in the post office by way of TCP/IP. 
The administrative message notifies the POA a GroupWise object has 
been added, modified, or deleted. 
Historical Note: In earlier versions of GroupWise, this function of the POA 
was handled by a separate agent, the Administration Agent (ADA). The 
ADA no longer exists in GroupWise. 

D de The POA creates a copy of the administrative message in the priority 2 

POA for subdirectory of the administrative input queue (wpcsout\ads) in the post 

Post Office POR office. After the update is made successfully, the copy will be deleted. 

(5) de The POA updates the post office database (wphost.db) to reflect the 
addition, modification, or deletion performed in GroupWise Administrator 

POA for dditi dificati deleti rf din G Wise Administrat 


Post Office POA and deletes the administrative message from its administrative input 
queue. 


Mapped/UNC Link between the Domain and the Post Office 


This message flow diagram illustrates how an administrative message, such as a database update 
request, passes from ConsoleOne to the agents so that databases are updated throughout the 
Group Wise system. In this diagram, the MTA writes the administrative message into the POA 
input queue in the post office. 
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Stage Actor Action 
a) The administrator uses GroupWise Administrator in ConsoleOne to add, 
GroupWise da modify, or delete a GroupWise object in a single-domain, single-post office 
Administrator GroupWise system. 
An object could be a GroupWise user, resource, distribution list, post office, 
secondary domain, and so on. 
@ € ConsoleOne performs the following actions: 
ConsoleOne + Updates the domain database (wpdomain.db) to reflect the addition, 


modification, or deletion performed in GroupWise Administrator. 


+ Creates an administrative message in the priority 2 subdirectory of the 
domain's MTA input queue (wpcsin) to replicate the update. 


progress" (gwinprog) queue. From there, the MTA transfers the administrative 

HTA message to the output queue in the post office. The MTA output queue is the 
input queue for the POA in the post office. The administrative message notifies 
the POA a GroupWise object has been added, modified, or deleted. 


@ MTA for a The MTA for the domain transfers the administrative message to the MTA "in 
Domain 


Historical Note: In earlier versions of GroupWise, this function of the POA was 
handled by a separate agent, the Administration Agent (ADA). The ADA no 
longer exists in GroupWise. 


@ POA for r4 The POA picks up the message from its administrative input queue in the post 


Post Office office, then updates the post office database (wphost.db) to reflect the addition, 
POA modification, or deletion performed in GroupWise Administrator. 
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Directory Structure Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand the 
structure of GroupWise® message transfer/storage directories (such as domains and post offices) 
and software installation directories. 


+ “Message Transfer/Storage Directories” on page 57 
+ “Agent Installation Directories” on page 97 
+ “Software Distribution Directory” on page 137 


+ “GroupWise Client Installation Directories” on page 153 
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Message Transfer/Storage Directories 


Message transfer and storage directories are the locations through which messages pass as they 
travel from user to user through your GroupWise” system. 


+ “Domain Directory” on page 57 


+ “Post Office Directory” on page 64 


+ “MTA Local Queue Directory” on page 76 


+ “Internet Agent Queue Directory” on page 80 


+ “WebAccess Agent Queue Directory” on page 86 


+ “Caching Mailbox Directory” on page 89 


+ “Remote Mailbox Directory” on page 93 


Domain Directory 
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Domain directory 


MTA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 
Normal priority status responses 
Low priority messages 


Low priority status responses 
Supporting program directory 
GroupWise gateway directory 


MTA output queue directory 
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Es) ads MTA admin thread input queue directory 


ml o Restart requests 

Ea 1 Directory synchronization requests 

Es 2 Database updates 

Es) 3 Reserved; not currently used 

E 4 Reserved; not currently used 

E 5 Reserved; not currently used 

Es 6 Reserved; not currently used 

E 7 Reserved; not currently used 

Es) css MTA input queue directory for administrative messages 

[| 0 MTA restart requests 

Es 1 Statistics requests 

Es 2 Other non-priority administrative requests 

2 3 Reserved; not currently used 

E 4 Reserved; not currently used 

eS 5 Reserved; not currently used 

ES) 6 Reserved; not currently used 

[| 7 Reserved; not currently used 

Es) problem Directory for undeliverable messages 

L mtaname Domain name identifier 
LJ wpdomain.db Domain database 
J wpdomain.dc Data dictionary for 4.x domain databases 
Ll wphost.dc Data dictionary for 4.x post office databases 
Ll gwdom.dc Data dictionary for 5.x and 6.x domain databases 
LJ gwpo.dc Data dictionary for 5.x and 6.x post office databases 
J Agentinstall.txt List of information provided during agent installation 


domain directory 


Within the Group Wise system, a domain is hierarchically the highest level object. It organizes post 
offices into a logical grouping for addressing and routing purposes. Each user in the domain has 
an address that consists of the user’s GroupWise user ID, the user’s post office name, and the 
domain name (user.post_office.domain). The explicit name is not displayed in the Address Book, 
but is stored in the domain database (wpdomain.db). 


wpcsin directory 


The wpcsin subdirectory in the domain is the MTA input queue in each domain. It contains eight 
priority subdirectories to handle different types of message traffic. 


+ Incoming user messages are queued by priority for routing to recipients’ post offices in the 
local domain. 
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0 directory 


1 directory 


2 directory 


+ Incoming status messages are queued by priority for routing to senders’ post offices in the 
local domain. 


+ Outgoing administrative messages are queued for replication to other domains. 


+ In a routing domain, messages pass through this directory on their way to the next domain. 
When a new message arrives, the MTA routes it to the appropriate destination. 


For TCP/IP links, the MTA is notified immediately when a message arrives for processing. For 
mapped and UNC links, the MTA scans its input queue for messages to process. You can control 
the rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input Queues 
in the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 6.5 Administration 
Guide. 


Historical Note: WP Office*, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation* (WPCorp*). The Message Transfer Agent (MTA) was originally 
named the Connection Server (CS). Hence, the directory name wpcsin for the MTA input queue. 
Some naming conventions were originally preserved for backward compatibility. 


The priority 0 subdirectory of the MTA input queue (wpcsin) in the domain is for service requests 
that demand an immediate response from the MTA. For example: 


+ ConsoleOne® places restart requests and queue reconfiguration requests here for the MTA and 
gateways. 


+ MTAs for other domains route Busy Search requests through here when users in other 
domains check schedules of users in the local domain. 


You can increase throughput for the priority 0 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the domain is for service requests 
of the next highest priority. For example: 


+ ConsoleOne places directory synchronization requests here for the MTA admin thread. 


+ ConsoleOne places statistics requests here for the MTA to relay to the message logging 
module for processing. 


+ MTAs for other domains route GroupWise Remote requests through here when Group Wise 
Remote users do not connect to the post office where their master mailboxes are located. 


You can increase throughput for the priority 1 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority 
messages. For example: 


+ MTAs for other domains place incoming high priority user messages here. The local MTA 
then routes the messages to recipients’ post offices. 
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3 directory 


4 directory 


5 directory 


6 directory 


7 directory 


+ MTAs for other domains place incoming administrative messages here to replicate database 
updates in the local domain. 


+ The MTA admin thread places outgoing administrative messages here to replicate database 
updates to other domains. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 6.5 Administration Guide. 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority 
status messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to high priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can 
be updated with current message status. 


You can increase throughput for the priority 2 and 3 subdirectories.See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 6.5 Administration Guide. 


The priority 4 subdirectory of the MTA input queue (wpcsin) in the domain is for normal priority 
user messages routed to recipients in local post offices. 


For example, MTAs for other domains place normal priority user messages here. The local MTA 
then routes the messages to recipients’ post offices. Most messages in your Group Wise system 
pass through the priority 4 subdirectory. 


You can increase throughput for the priority 4 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the domain is for normal priority 
status messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to normal priority user messages 
here. The local MTA then routes the status messages to senders’ post offices, so senders’ 
mailboxes can be updated with current message status. 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority user 
messages routed to recipients in local post offices. 


For example, MTAs for other domains place low priority user messages here. The local MTA then 
routes the messages to recipients' post offices. 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority 
status messages routed back to senders in local post offices. 
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For example, MTAs for other domains place status responses to low priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can 
be updated with current message status. 


wptools directory 


The wptools subdirectory in the domain contains programs that support GroupWise 
administration. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Hence, the wp in wptools. Some naming conventions were 
originally preserved for backward compatibility. 


wpgate directory 


The wpgate subdirectory in the domain contains a subdirectory for each GroupWise gateway you 
have installed in your GroupWise system. For a list of gateways, see GroupWise 6.x Gateways 
(http://www.novell.com/documentation/gw6xgate/index.html). Group Wise 5.5 gateways can be 
used with GroupWise 6.x. 


wpcsout directory 


ads directory 


The wpcsout subdirectory in the domain is the MTA output queue in each domain. It contains 
subdirectories that function as input queues for the processes to which the MTA delivers messages. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some 
naming conventions were originally preserved for backward compatibility. 


The ads subdirectory of the MTA output queue (wpcsout) in the domain is the input queue for the 
MTA admin thread in each domain. It contains priority subdirectories where incoming 
administrative messages are queued for processing. When a new administrative message arrives, 
the MTA admin thread performs the requested action. 


Historical Note: The MTA admin thread was previously part of a separate agent, the 
Administration Agent (ADA), which was originally named the Administration Server (ADS). 
Hence, the directory name ads. Some naming conventions were originally preserved for backward 
compatibility. 


0 directory 


The priority 0 subdirectory of the MTA admin thread input queue (wpcsout\ads) in the domain is 
for service requests that demand an immediate response from the MTA admin thread. 


For example, when you create or delete a post office in ConsoleOne, a restart request is placed 
here. The domain MTA admin thread processes the request and then restarts. 


1 directory 


The priority 1 subdirectory of the MTA admin thread input queue (wpcsout\ads) in the domain is 
for service requests of the next highest priority. 
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css directory 


problem directory 


2 directory 


The priority 2 subdirectory of the MTA admin thread input queue (wpcsout\ads) in the domain is 
for high priority administrative messages. For example: 


+ The MTA places administrative messages from other domains here. The administrative 
messages might instruct the MTA admin thread to add, modify, or delete users, post offices, 
or other objects in the domain. The MTA admin thread then processes the messages and makes 
the specified updates. 


+ When you use the Synchronize utility in ConsoleOne, a synchronization request is placed 
here. The MTA admin thread then resends the specified administrative messages to produce 
the required database updates. 


The css subdirectory of the MTA output queue (wpcsout) in the domain is processed by a 
specialized MTA thread that responds to requests regarding its own configuration. It contains the 
eight standard priority subdirectories. 


Historical Note: In an earlier version of GroupWise, the Message Transfer Agent (MTA) was 
called the Connection Server (CS) and this specialized subprocess was called the Connection 
Server Server (css). Some naming conventions were originally preserved for backward 
compatibility. 


0 directory 


The priority 0 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests that demand an immediate response from the MTA. 


For example, when you restart the MTA at the MTA agent console or in ConsoleOne, a restart 
request is placed here. The MTA processes the request and restarts. 


1 directory 


The priority 1 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests of the next highest priority. 


For example, each time the statistics are updated on the MTA agent console, a statistics request is 
placed here. The MTA then gathers the statistics and displays them on the MTA agent console. 


2 directory 


The priority 2 subdirectory of the css input queue (wpcsout\css) in the domain is for non-priority 
requests. 


The problem subdirectory of the MTA output queue (wpcsout) in the domain is where the MTA 
places message files that cannot be delivered because they are damaged in some way. Message 
files in the problem directory must be handled by the GroupWise administrator. See “Message Is 
Dropped in the problem Directory in the Domain” in GroupWise 6.5 Troubleshooting 2: Solutions 
to Common Problems. 
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mtaname file 


The mtaname file in the domain provides the domain name associated with the domain directory 
structure. This can help you locate the domain information for the directory structure in 
ConsoleOne. It can also help you check links between MTAs. 


wpdomain.db file 


The wpdomain.db file in the domain is the domain database. It contains all administrative 
information for the domain. 


In the primary domain, the wpdomain.db file contains all administrative information for your 
entire Group Wise system (all its domains, post offices, users, and so on). Because the 
wpdomain.db file in the primary domain is so crucial, you should back it up regularly and keep it 
secure. (You can re-create your entire GroupWise system from the primary domain wpdomain.db 
file; however, if the primary domain wpdomain.db file becomes unusable, you can no longer make 
administrative updates to your GroupWise system.) 


In a secondary domain, the wpdomain.db file contains administrative information about that 
secondary domain only. 


In GroupWise 6.x and 5.x domains, the data dictionary for the wpdomain.db file is the gwdom.dc 
file. In groupwise 4.x domains, the data dictionary is the wpdomain.dc file. As a result, 
wpdomain.db files have different structures (schemas) depending on whether they were created for 
6.x/ 5.x or 4.x domains. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.db. Some naming conventions 
were originally preserved for backward compatibility. 


wpdomain.dc file 


wphost.dc file 


The wpdomain.dc file in the domain is the data dictionary for rebuilding GroupWise 4.x domain 
databases (wpdomain.db files) in secondary domains. 


If the wpdomain.dc file is missing from the primary domain, you cannot rebuild Group Wise 4.x 
secondary domains. The original wpdomain.dc file is located in the domain subdirectory of the 
software distribution directory or on the GroupWise CD. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.dc. Some naming conventions 
were originally preserved for backward compatibility. 


The wphost.dc file in the domain is the data dictionary for rebuilding GroupWise 4.x post office 
databases (wphost.db files). 


If the wphost.dc file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wphost.dc file is located in the domain directory of the software 
distribution directory or on the GroupWise CD. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.dc. Some naming conventions were originally preserved for backward compatibility. 
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gwdom.dc file 


The gwdom.dc file in the domain is the data dictionary for creating and rebuilding Group Wise 6.x 
and 5.x domain databases (wpdomain.db files) in secondary domains. 


If the gwdom.dc file is missing from the primary domain, you cannot create or rebuild Group Wise 
6.x/5.x secondary domains. The original gwdom.dc file is located in the domain directory of the 
software distribution directory or on the GroupWise distribution media. 


gwpo.dc file 


The gwpo.dc file in the domain is the data dictionary for creating and rebuilding GroupWise 6.x 
and 5.x post office databases (wphost.db files). 


If the gwpo.dc file is missing from a domain, you cannot create or rebuild GroupWise 6/x/5.x post 
offices in that domain. The original gwpo.dc file is located in the domain directory of the software 
distribution directory or on the GroupWise distribution media. 


agentinstall.txt 


The agentinstall.txt file in the domain records all the information that you provide when you install 


the MTA for the domain. 


Post Office Directory 


Es post_office 


E wpcsin 
Mo 
È + 
> 
È 3 
w, 
@ 5 
Me 6 
%7 

de gwdms 
LÌ dmsh.db 


Œ 1ib0001-ff 
Es) dmxxnn01-ff.db 
E index 
Es) archive 
docs 
T fa00-# 


Post office directory 


MTA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 
Normal priority status responses 
Low priority messages 


Low priority status responses 


Document Management Services directory 


Shared Document Management Services database 


Library directories 

Document databases 
QuickFinder™ index for library 
Archive directory for library 

Large document directory for library 


Subdirectories for documents 
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En ofmsg 
J msgnn.db 
J ngwdfr.db 
Ea guardbak 


w ofuser 
L] userxxx.db 
J puxxxxx.db 
w index 

| offiles 
T tao-f6 


E ofviews 


En ofwork 
Es) ofdirect 


ES wpcsout 


dl ofs 

Mo 

È + 

@ > 

MN 3 

BN a 

@ 5 

Bc 

7 

J mmddpoa.nnn 
_] wprof50.db 


Message database directory 
As many as 25 message databases 
Deferred message database 


Backup guardian database 


User database directory 
User databases (one per user) 
Databases for shared folders 


QuickFinder index for messages 


Attachment store directory 


Subdirectories for attachments 
GroupWise client view files 


GroupWise working directory 


Remote direct connection directory 
MTA output queue directory 


POA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 
Normal priority status responses 
Low priority messages 

Low priority status responses 
POA log files 


Downloadable system Address Book 


POA admin thread input queue directory 
Restart requests 

Directory synchronization requests 
Database updates 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 


Reserved; not currently used 


GWCheck working directory 
GWCheck priority subdirectories 
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y defer GWCheck subdirectory for deferred database maintenance 


requests 

E problem Directory for undeliverable messages 
LJ wphost.db Post office database 
LJ gwpo.dc Data dictionary for GroupWise 6.x/5.x post office databases 
J ngwguard.db Guardian database 
L ngwguard.dc Data dictionary for databases 
J ngwguard.fbk Guardian database backup 
Ll ngwguard.rfl Guardian database roll forward log 
J ngwcheck.db GWCheck control database 
J agenitinstall.txt List of information provided during agent installation 


post_office directory 


Conceptually, a post office contains mailboxes for a set of network users. The users on the post 
office send and receive messages through their mailboxes. 


Physically, a post office is a directory structure on a network file server. The directory structure 
contains subdirectories and databases that store messages and the information used to distribute 
the messages. 


wpcsin directory 


The wpcsin subdirectory in the post office is the MTA input queue in each post office. It contains 
eight priority subdirectories to handle different types of message traffic. 


+ Outgoing user messages are queued by priority for routing to recipients in other post offices. 
+ Outgoing status messages are queued by priority for routing back to senders’ post offices. 


+ Outgoing Busy Search requests are queued for routing to other post offices so users’ schedules 
can be checked. 


+ GroupWise Remote requests are queued for routing to GroupWise Remote users’ master 
mailboxes. 


When a new message arrives, the MTA routes it to the appropriate destination. 


For mapped and UNC links, the MTA scans its input queue for messages to process. You can 
control the rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input 
Queues in the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 6.5 
Administration Guide. 


For TCP/IP links, the POA passes messages to the MTA via TCP/IP. A copy is kept in the MTA 
input queue until the POA has successfully transferred the message. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory name wpcsin for the MTA input queue. Some 
naming conventions were originally preserved for backward compatibility. 
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0 directory 


1 directory 


2 directory 


3 directory 


4 directory 


The priority 0 subdirectory of the MTA input queue (wpcsin) in the post office is for service 
requests that demand an immediate response from the MTA. 


For example, the GroupWise client places Busy Search requests here. The MTA then routes the 
requests to the appropriate post offices, so users’ schedules can be checked. 


You can increase throughput for the priority 0 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the post office is for service 
requests of the next highest priority. For example: 


+ Remote with a direct connection places requests here for routing to GroupWise Remote users” 
master mailboxes. 


+ The POA places outgoing status messages to Group Wise Remote users here for routing to the 
async connection. 


You can increase throughput for the priority 1 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
user messages routed to recipients in other post offices, domains, or systems. 


For example, the Group Wise client places high priority user messages here. The MTA then routes 
the messages to the appropriate destinations. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 6.5 Administration Guide. 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to high priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so 
senders’ mailboxes can be updated with current message status. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 6.5 Administration Guide. 


The priority 4 subdirectory of the MTA input queue (wpcsin) in the post office is for normal 
priority user messages routed to recipients in other post offices, domains, or systems. 
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5 directory 


6 directory 


7 directory 


For example, the GroupWise client places normal priority user messages here. The MTA then 
routes the messages to the appropriate destinations. Most messages in your GroupWise system 
pass through the priority 4 subdirectory. 


You can increase throughput for the priority 4 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 
6.5 Administration Guide. 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the post office is for normal 
priority status messages routed back to senders in other post offices, domains, or systems. 


For example, the Group Wise client and local POA place status responses to normal priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so 
senders’ mailboxes can be updated with current message status. 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority 
user messages routed to recipients in other post offices, domains, or systems. 


For example, the GroupWise client places low priority user messages here. The MTA then routes 
the messages to the appropriate destinations. 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to low priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so 
senders’ mailboxes can be updated with current message status. 


gwdms directory 


dmsh.db file 


The gwdms subdirectory in the post office is the Document Management Services (DMS) 
directory in each post office. It contains the document libraries associated with the post office. 


The dmsh.db file in the document management subdirectory (gwdms) in the post office is a 
database shared by all libraries in the post office. It contains a list of all available libraries and 
lookup tables for each library. 


lib0001-ff directories 


The lib000/-/f subdirectories in the gwdms subdirectory in the post office contain the libraries for 
the post office, with one library per directory. You can create a maximum of 256 libraries in a post 
office. 


dmxxnn01-ff.db files 


The dmxxnn01-ff-db files in the library subdirectories (lib000/-//) in the post office are databases 
for library and document information. 
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The nn in the filenames represents the partition number, which is generated by a hashing algorithm 
to guarantee uniqueness. 


The 0/-ffin the filenames represents the library number, matching the number on the library 
directory in which the database is found. 


dmsdnn01-ff.db file 
The dmsdnn01-ff-db file in each library holds system data for the library, such as library 
configuration information. 


dmddnn01-ff.db file 
The dmddnn0/1-ff-db file in each library holds document data for the library. Document data is the 
document property information for documents in the library. 


dmdlran01-ff.db file 
The dmdlrn01-ff.db file in each library holds document logging data for the library. Document 
logging data records all activities performed on documents in the library. 


index directory 


The index subdirectories in the library subdirectories (1ib000/-ff) in the post office contain the 
QuickFinder index for the documents contained in the library. 


archive directory 


The archive subdirectories in the library subdirectories (1ib000/-//) in the post office contain an 
array of subdirectories for holding archived documents. The subdirectories are numbered 
sequentially. When the first archive subdirectory reaches its maximum allowable size, archived 
documents are stored in the next sequential directory, and so on. 


docs directory 


The docs subdirectories in the library subdirectories (lib000/-//) in the post office contain an array 
of subdirectories for storing documents. 


fd0-ff directories 

The fd0-ff subdirectories in the docs subdirectory in the post office store documents that are equal 
to or greater than 2 KB in size. The 0-ff variable represents hexadecimal number 0 through ff, so 
the subdirectories are named fd0 through fdff. The document databases (dmxxnn01-ff-db files) 
contain pointers to documents stored in the subdirectories of the docs directory. 


ofmsg directory 


msgnn.db file 


The ofmsg subdirectory in the post office contains as many as 25 databases where messages are 
stored. It serves as centralized storage for all users in the post office. A message must be stored 
only once to be delivered to any number of users in the same post office. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofmsg. Some naming conventions were 
originally preserved for backward compatibility. 


The msgvn.db files in the ofmsg subdirectory in the post office are the message databases where 
users’ messages smaller than 2 KB are stored. To increase database efficiency, messages, 
attachments, and recipient lists equal to or greater than 2 KB are stored outside the msgnn.db files 
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ngwdfr.db file 


guardbak directory 


in an array of subdirectories in the offiles directory. After the 2 KB limit is reached, only pointers 
are stored in the message databases. 


The nn variable in the database names is a two-digit number from zero to 24. A hashing algorithm 
takes each user’s GroupWise file ID (FID) to derive which database the user’s outgoing mail is 
assigned to. The contents of the messages databases are encrypted so the text of message can only 
be read through Group Wise. 


Multiple users are assigned to the same message database. You can use GWCheck to determine 
which database a specific user has been assigned to. See “GroupWise Check” in “Standalone 
Database Maintenance Programs” in the GroupWise 6.5 Administration Guide. 


The ngwdfr.db file in the ofmsg subdirectory in the post office holds deferred messages that users 
have specified for delivery at a later time. When users delay delivery on messages, the messages 
are transferred to the receiving post office and held in the ngwdfr.db file until the delay expires. 


Historical Note: Earlier versions of GroupWise handled deferred messages through the ofpend 
directory in the post office. 


The guardbak subdirectory in the ofmsg subdirectory in the post office holds a backup copy of the 
ngwguard.fbk file. 


ofuser directory 


userxxx.db file 


The ofuser subdirectory in the post office contains a separate database (mailbox) for each 
GroupWise user. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofuser. Some naming conventions were 
originally preserved for backward compatibility. 


The userxxx.db files in the ofuser subdirectory in the post office are user databases where the 
contents of users’ mailboxes are stored, as displayed in the GroupWise client In addition, each user 
database contains: 


+ Some personal GroupWise client program settings 
+ Personal appointments 

+ Personal groups 

+ Personal notes 

+ Rules 


Personal client settings that remain the same regardless of what workstation a user logs in to are 
stored in the user database. Personal client settings that are customized for a particular workstation 
are stored in the Windows* Registry. 


The xxx variable in the database names is each user’s GroupWise file ID (FID). 
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puxxxxx.db file 


index directory 


The puxxxxx.db files in the ofuser subdirectory in the post office are databases for replicated items 
such as shared folders. These databases prevent conflicts between user names of shared items from 
users in other post offices and user names in the local post office. 


The index subdirectory in the ofuser subdirectory in the post office contains the QuickFinder index 
for users’ messages stored in the post office. 


offiles directory 


fd0-f6 directories 


The offiles subdirectory in the post office contains subdirectories for messages, attachments, and 
recipient lists that are equal to or greater than 2 KB in size. These larger messages, attachments, 
and recipient lists are stored outside the actual message databases in the ofmsg directory to 
increase database efficiency. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in offiles. Some naming conventions were 
originally preserved for backward compatibility. 


The fd0-/6 subdirectories in the offiles subdirectory in the post office store messages, attachments, 
and recipient lists that are equal to or greater than 2 KB in size. The nn variable represents 
hexadecimal number 0 through f6, so the subdirectories are named fd0 through fdf6. The message 
databases (msgnn.db files) contain pointers to messages, attachments, and recipient lists stored in 
the subdirectories of offiles. 


ofviews directory 


The ofviews subdirectory in the post office contains subdirectories for Group Wise client 
platforms. Within the platform-specific subdirectories (for example, win) are view (*.vew) files 
that create the various views displayed in the Group Wise client. 


The gwviewxx.ini and ofviewxx.ini files configure the standard views on the menus where users 
select views. The gwviewxx.ini file configures Group Wise 6 and GroupWise 5.5 standard views. 
The ofviewxx.inI file configures standard views from earlier versions of Group Wise. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofviews. Some naming conventions were 
originally preserved for backward compatibility. 


ofwork directory 


The ofwork subdirectory in the post office is a working directory for GroupWise Remote. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofwork. Some naming conventions were 
originally preserved for backward compatibility. 
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ofdirect directory 


The ofdirect subdirectory in the working directory (ofwork) in the post office is used by 
GroupWise Remote for direct connections. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofdirect. Some naming conventions were 
originally preserved for backward compatibility. 


wpcsout directory 


ofs directory 


The wpcsout subdirectory in the post office is the MTA output queue in each post office. It 
contains subdirectories which function as input queues for the other agents to which the MTA 
delivers messages. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some 
naming conventions were originally preserved for backward compatibility. 


The ofs subdirectory of the mta output queue (wpcsout) in the post office is the POA input queue 
in each post office. It contains eight priority subdirectories to handle different types of message 
traffic. 


+ Incoming user messages are queued by priority for delivery to recipients’ mailboxes in the 
local post office. 


+ Incoming status messages are queued by priority for delivery to senders’ mailboxes in the 
local post office. 


+ Incoming Busy Search requests are queued for the POA to check users’ schedules in the local 
post office. 


The POA scans these priority subdirectories regularly. When a new message arrives, the POA 
processes the messages and performs the required actions. 


0 directory 


The priority 0 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for service 
requests that demand an immediate response from the POA. 


For example, the MTA places Busy Search requests here so the POA can check recipients’ 
schedules and quickly return the schedule information to the sender. 


1 directory 


The priority 1 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for service 
requests of the next highest priority. 


For example, the MTA places requests from GroupWise Remote users for items in their master 
mailboxes here. The POA then processes the messages and returns the requested items. 


2 directory 


The priority 2 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for high 
priority user messages being delivered to recipients in the local post office. 
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For example, the MTA places high priority user messages here. The POA then updates the message 
databases and recipients’ mailboxes. 


3 directory 


The priority 3 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for high 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to high priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


4 directory 


The priority 4 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for normal 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places normal priority user messages here. The POA then updates the 
message databases and recipients’ mailboxes. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 


5 directory 


The priority 5 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for normal 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to normal priority user messages here. The POA 
then updates the message databases and senders’ mailboxes with current message status. 


6 directory 


The priority 6 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for low 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places low priority messages here. The POA then updates the message 
databases and recipients’ mailboxes. 


7 directory 


The priority 7 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for low 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to low priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


mmddpoa.nnn files 


The mmddpoa.nnn files are POA log files. The POA creates log files to inform you of its 
processing and any problems it encounters. By default, these log files are created in the 
wpcsout\ofs directory. You can change the location if needed. See “Using POA Log Files” in “Post 
Office Agent” in the GroupWise 6.5 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of 
the month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa.002 is the second POA log file created on May 18. 
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ads directory 


chk directory 


problem directory 


wprof50.db file 


The wprov50.db file in the wpcsout\ofs directory is the downloadable system Address Book for 

Remote client users. By default, it is automatically re-created once a day to keep it up to date. See 
“Performing Nightly User Upkeep” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide guide. 


The ads subdirectory of the MTA output queue (wpcsout) in the post office is the input queue for 
the POA admin thread in each post office. It contains priority subdirectories where administrative 
messages are queued for processing. 


Historical Note: The POA admin thread was previously part of a separate agent, the 
Administration Agent (ADA), which was originally named the Administration Server (ADS). 
Hence, the directory name ads. Some naming conventions were originally preserved for backward 
compatibility. 


0 directory 


The priority 0 subdirectory of the POA admin thread input queue (wpcsout\ads) in the post office 
is for service requests that demand an immediate response from the POA admin thread. 


1 directory 


The priority | subdirectory of the POA admin thread input queue (wpcsout\ads) in the post office 
is for service requests of the next highest priority. 


For example, a directory synchronization request that could not be performed when the POA 
admin thread received it in its domain input queue would be placed here in the post office for later 
processing. 


2 directory 


The priority 2 subdirectory of the POA admin thread input queue (wpcsout\ads) in the post office 
is for high priority administrative messages. 


For example, a database update request that could not be performed when the POA admin thread 
received it in its domain input queue would be placed here in the post office for later processing. 


The chk subdirectory of the MTA output queue (wpcsout) in the post office is the working 
directory where the multithreaded GWCheck process keeps temporary files during database 
maintenance and where it tracks the activities of its various threads. 


The problem subdirectory of the mta output queue (wpcsout) in the post office is a holding area 
for damaged message files. Problem files are marked with an extension indicating which 
Group Wise agent placed each file in the problem directory. 


You should check this directory periodically for problem files, resolve the problem, then place the 
files back into the appropriate queue for continued processing. For assistance, see “Message Is 
Dropped in the problem Directory in the Post Office” in “Strategies for Message Delivery 
Problems” in the GroupWise 6.5 Troubleshooting 2: Solutions to Common Problems. 
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wphost.db file 


gwpo.dc file 


The wphost.db file in the post office is the post office database. It contains all administrative 
information for the post office. It also contains the Address Book for the post office. 


In GroupWise 6.x and 5.x post offices, the data dictionary for the wphost.db file is the gwpo.dc 
file. In GroupWise 4.x post offices, the data dictionary is the wphost.dc file. As a result, wphost.db 
files have different structures (schemas) depending on whether they were created for GroupWise 
6.x/5.x or 4.x post offices. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.db. Some naming conventions were originally preserved for backward compatibility. 


The gwpo.dc file in the post office is the data dictionary for creating and rebuilding GroupWise 
6.x and 5.x post office databases (wphost.db files). 


If the gwpo.dc file is missing from a post office and its domain, you cannot create or rebuild 
Group Wise 6.x/5.x post offices in that domain. The original gwpo.dc file is located in the domain 
directory of the software distribution directory or on the GroupWise CD. 


ngwguard.db file 


The ngwguard.db file in the post office is the guardian database. See “Information Stored in the 
Post Office” in “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


ngwguard.dc file 


The ngwguard.dc file in the post office is the data dictionary for building the following databases 
in the post office: 


+ newguard.db (guardian database) 

+ dmxxnn01-ff-db (document management databases) 
+ msgnn.db (message databases) 

+ userxxx.db (user databases) 


+ puxxxxx.db (databases for replicated items like shared folders) 


ngwguard.fbk file 


The ngwguard.fbk file in the post office is a “fall back” copy of the ngwguard.db file. If the 
ngwguard.db file becomes damaged, the ngwguard.fbk file, along with the ngsguard.rfl file, can 
be used to rebuild a valid, current ngwguard.db file. The ngwguard.fbk file is so important that an 
additional copy of it is kept in the ofmsg\guardbak subdirectory in case the copy in the post office 
directory is inadvertently deleted. See “Guardian Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 
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ngwguard.rfl file 


The ngwguard.rfl file in the post office is a roll-forward transaction log of every database 
transaction that has taken place since the last copy of the ngwguard.fbk file was created. See 
“Guardian Databases” in “Databases” in the GroupWise 6.5 Administration Guide. 


ngwcheck.db 
The ngwcheck.dbfile in the post office is the database that controls GWCheck’s multithreaded 
processing. It contains job and task records that are used to synchronize and summarize GWCheck 
requests as they progress. 

agentinstall.txt 


The agentinstall.txt file in the post office records all the information that you provide when you 
install the POA for the post office. 


MTA Local Queue Directory 


3 mslocal MTA local working directory 
L] mmddxxx.nn MTA log files 
En) msglog Message logging directory 
LJ mmddmsg.nn Message logging files 
Es) gwinprog MTA "in progress" queue directory 
E 0-7 Priority subdirectories 
E mshold MTA holding directory 
E domainms Processing directory for MTA 
ey 0-7 Priority subdirectories 
J mtaname Location identifier 
T postx Holding directories for post offices 
3 0-7 Priority subdirectories 
_] mtaname Location identifier 
de gatewayx Holding directories for gateways 
Tal 0-7 Priority subdirectories 
_] mtaname Location identifier 
E domainx Holding directories for other domains 
ey 0-7 Priority subdirectories 
_] mtaname Location identifier 
T gwvsscan Working directory for third-party virus scanning programs 
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E) mtaconv Work area for 5.x to 4.x conversion 


mslocal directory 


mmddxxx.nnn files 


The mslocal directory is the MTA local working directory. The /work startup switch of the MTA 
specifies the location of the mslocal directory. It must be located on the hard disk of the server 
where the MTA runs so it is always accessible. Adequate disk space must be available to hold 
messages going to destinations that are temporarily closed. 


Typical locations for the mslocal directory include: 
¢ sys:\system on a NetWare® server 


+ c:\ona Windows server 


To move the mslocal directory, stop the MTA, the copy the mslocal directory, along with all its 
subdirectories, to the new location. Then restart the MTA and specify the new location using the / 
work startup switch. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms in mslocal. Some naming conventions were originally 
preserved for backward compatibility. 


The mmddxxx.nnn file are MTA log files. The MTA creates log files to inform you of its processing 
and any problems it encounters. By default, these log files are created in the mslocal directory. You 
can change the location if needed. See “Using MTA Log Files” in “Message Transfer Agent” in 
the GroupWise 6.5 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of 
the month; the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518mta.002 is the second MTA log file created on May 18. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms indicator representing the MTA. Some naming 
conventions were originally preserved for backward compatibility. 


msglog directory 


mmddmsg.nnn files 


The msglog subdirectory contains message logging files. It is created when you turn on message 
logging. The MTA receiver threads log messages as they arrive so the MTA worker threads can 
process messages without having to scan the MTA input queues to look for work. 


The resources used for message logging are configurable. See “Optimizing the Routing Queue” in 
“Optimizing the MTA” in the GroupWise 6.5 Administration Guide. 


More detailed message logging by the MTA is also available, but is turned off by default. See 
“Enabling MTA Message Logging” in “Configuring the MTA” in the GroupWise 6.5 
Administration Guide. 


The mmddmsg.nnn files in the message logging subdirectory (msglog) in the MTA local directory 
are used by the MTA to track messages in its “in progress” queue. 
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The first two digits of the filename represent the month; the next two digits represent the day of 
the month. The three-digit extension is a sequence number for multiple files created on the same 
day. For example, 0518msg.002 is the second message logging file created on May 18. 


gwinprog directory 


The gwinprog subdirectory is the MTA “in progress” queue. It contains eight priority 
subdirectories parallel to those found in wpcsin. All messages for recipients in the domain pass 
through gwinprog, no matter whether they arrived by way of TCP/IP or by way of message files 
deposited into the MTA input queue by a POA or another MTA. 


The resources used to process the “in progress” queue are configurable. See “Optimizing the 
Routing Queue” in “Optimizing the MTA” in the GroupWise 6.5 Administration Guide. 


mshold directory 


The mshold subdirectory is a holding queue for messages addressed to domains, post offices, or 
gateways that are currently closed. 


A location might be closed because its server is down or because the MTA is unable to 
communicate with it for any other reason. When a closed location is again open, the MTA moves 
messages from the holding queue back into the normal message flow. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms in mshold. Some naming conventions were originally 
preserved for backward compatibility. 


domainms directory 


The domainms subdirectory in the holding directory (mshold) is used for internal processing by 
the MTA. It does not contain any files a GroupWise administrator needs to access. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms in domainms. Some naming conventions were originally 
preserved for backward compatibility. 


postx directories 


The postx subdirectories in the holding directory (mshold) represent post offices in the domain. If 
a post office is closed, the MTA routes messages for that post office into its holding queue in 
mshold. When the post office is open, the MTA moves the messages from the holding queue back 
into the regular message flow. For more information, see “Message Delivery to a Different Post 
Office” on page 15. 


The name of the holding queue for each post office consists of the first three characters of the post 
office name, followed by four hashed characters to ensure uniqueness. 


gatewayx directories 


The gatewayx subdirectories in the holding directory (mshold) represent gateways in the domain. 
If a gateway is closed, the MTA routes messages for that gateway into its holding queue in mshold. 
When the gateway is open, the MTA moves the messages from the holding queue back into the 
regular message flow through the gateway. 
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The name of the holding queue for each gateway consists of the first three characters of the 
gateway name, followed by four hashed characters to ensure uniqueness. 


domainx directories 


0-7 directories 


mtaname files 


The domainx subdirectories in the holding directory (mshold) represent domains to which the 
current domain has a direct link. If a domain is closed, the MTA routes messages for that domain 
into its holding queue in MSHOLD. When the domain is open, the MTA moves the messages from 
the holding queue back into the regular message flow. For more information, see “Message 
Delivery to a Different Domain” on page 27. 


The name of the holding queue for each domain consists of the first three characters of the domain 
name, followed by four hashed characters to ensure uniqueness. 


The priority 0-7 subdirectories in each holding queue in the mshold subdirectory correspond to the 
priority 0-7 subdirectories located in each domain, post office, or gateway. See the following 
directory structures for more information about its priority 0-7 subdirectories: 


+ “Domain Directory” on page 57 


+ “Post Office Directory” on page 64 


The mtaname files in the closed location holding queues provide the name associated with the 
domain, post office, or gateway holding queue. They can help you check links between MTAs in 
ConsoleOne without going to the MTA agent console to determine the location name. To associate 
a location name with its holding queue directory from the MTA agent console, click Configuration 
Status > select the location > click Details. 


gwvsscan directory 


The gsvsscan subdirectory is the working directory where third-party virus scanning programs that 
snap in to the MTA can perform their processing. 


mtaconv directory 


The mtaconv subdirectory is the working directory where the MTA converts GroupWise 6.x and 
GroupWise 5.x messages to 4.x format for transfer to a GroupWise 4.x system. After the 
conversion is finished, this directory should be empty. 
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Internet Agent Queue Directory 


The following directories and files are found under the \domain\wpgate\ structure for the Internet 
Agent after the software has been installed and the Internet Agent has processed messages. 


w domain\wpgate\gwia GroupWise Internet Agent home directory 


3 000.prc Internet Agent message processing directory 
3 cmd Not currently used 
E gwwork Hold directory for temporary files using during processing 
J mmddlog.nnn Log files 
L acct Accounting file 
L set Settings file for screen colors, log levels, and so on 
L stat Statistics file for Internet Agent operation 
LJ proc Process lock file indicating that the Internet Agent is running 
LJ pulse.tmp Temporary file to verify Internet Agent operation 
3 wpcsin MTA input queue directory 
E 0-7 Message priority subdirectories 
E] wpcsout MTA output queue 
Es QWÍXXXX System-defined directory 
ds 0-7 Message priority subdirectories 
a problem Hold directory for damaged outbound messages 
Es gwhold Message hold directory 
Es qfiles Delayed delivery hold directory 
Es gwprob Hold directory for damaged inbound messages 
Es) gwchars Directory for character conversion tables 
E] save Directory for old configuration files from reinstalls or upgrades 
LJ gwia.cfg Internet Agent configuration file for startup switches 
Lj route.cfg Route configuration file to customize routing 


JJ gwauth.cfg 
LJ mimetype.cfg 
LJ exepath.cfg 


LJ gwac.db 
úl gwac.dc 


J preamble.txt 
L] preamble.all 


Host authentication configuration file 
MIME encoding configuration file for various file types 


Configuration file pointing ConsoleOne to the gwia.cfg file 


Access control database 


Database dictionary file used to create the access control database 


Message for recipients who lack a MIME-compliant mail reader 


Preamble message in various languages 
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Ll blocked.txt List of blocked Internet sites 


J gwia.mib Internet Agent Management Information Base (MIB) (NetWare only) 
_] statusxx.xml File for customizing status messages 
3 gwia SMTP service (daemon) home directory 
E] send Outbound hold directory for converting messages into Internet format 
3 receive Incoming hold directory for converting messages into GroupWise format 
E result Send and result files to confirm transmission 
Ta defer Hold directory for re-queued and deferred messages 
Es) work Schedule files for SMTP service operations on deferred messages 
3 dsnhold Delivery Status Notification (DSN) hold directory 
Tal help Internet Agent Web console help file directory 


domain\wpgate\gwia directory 


000.prc directory 


The domain\wpgate\gwia directory is the GroupWise Internet Agent home directory where 
Internet Agent configuration files and queue directories are located. The name is established when 
you install the Internet Agent. The default is wpgate\gwia in the domain directory. You can change 
the location using the /home startup switch in the Internet Agent configuration file (gwia.cfg). 


The Internet Agent uses the 000.prc directory to process messages. 


gwwork directory 


The gwwork directory stores temporary files created by the Internet Agent as it converts and builds 
messages for transfer across the Internet. 


mmddlog.nnn file 


The mmddlog.nnn files hold error and status messages about the functioning of the Internet Agent. 
The Internet Agent creates a log file each day with a unique name, where mm is the month, dd is 
the day, and nnn is a sequential number indicating the sequence of log files in a single day. For 
more information log files, see “Using Internet Agent Log Files” in “Internet Agent” in the 
GroupWise 6.5 Administration Guide. 


acct file 


The acct file contains information about the messages the Internet Agent sends each day. It is e- 
mailed to the accounts each day at midnight. For more information about the accounting files, see 
“Setting Up Accounting” in “Internet Agent” in the GroupWise 6.5 Administration Guide. 


set file 


The set file stores Internet Agent console settings such as color, log settings, and so on. For more 
information, see “Monitoring the Internet Agent through the Server Console”. 
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wpcsin directory 


wpcsout directory 


gwhold directory 


gwprob directory 


stat file 


The stat file stores statistics about the Internet Agent’s functioning. For information about the 
statistics provided by the Internet Agent, see “Statistics” in “Internet Agent” in the GroupWise 6.5 
Administration Guide. 


proc file 


The proc file is the lock file for the Internet Agent process. The proc file is opened and locked when 
the Internet Agent starts. This prevents multiple Internet Agents from being started for the same 
domain. 


pulse.tmp file 


The pulse.tmp file is re-created by the Internet Agent every time it completes a cycle (after an idle 
loop). If you are not at the Internet Agent console but need to know if the Internet Agent is running, 
you can delete the pulse.tmp file. If the Internet Agent is running, it re-creates the file. 


The Internet Agent places inbound messages in one of the wpcsin priority subdirectories (0-7). 
Most messages go in the 4 directory, although some administrative and status messages might go 
in other directories. The Message Transfer Agent retrieves the messages and delivers them to the 
proper destinations. 


The wpcsout directory is the MTA output queue as well as being the Internet Agent input queue. 


gwixxxx directory 


The gwixxxx directory is a system-defined directory, where gwi represents the first three letters of 
the Internet Agent object name as defined during installation and displayed in ConsoleOne, and 
xxxx is arandomly-generated string. Here, the Message Transfer Agent places outbound messages 
in the appropriate 0-7 priority subdirectory for the Internet Agent to retrieve and process. 


problem directory 


The problem directory holds messages that the MTA cannot process. 


The gwhold directory holds messages that are scheduled for delayed delivery. 


qfiles directory 


The qfiles directory holds messages that cannot be sent during the current Send/Receive cycle. The 
messages are queued to this directory until the next cycle. 


The delayed delivery messages waiting in the qfiles directory remain in encrypted format until the 
Internet Agent transfers them to the send directory for processing by the SMTP service. 


The Internet Agent uses the gwprob directory for messages it cannot process. These are usually 
messages that have been damaged during transmission or that have the wrong Internet address. 
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gwchars directory 


save directory 


gwia.cfg file 


route.cfg file 


gwauth.cfg file 


mimetype.cfg file 


exepath.cfg file 


gwac.db file 


This directory contains conversion tables that the Internet Agent uses to convert message 
attachments between character sets. 


If you reinstall or upgrade the Internet Agent, your old configuration files are copied to the save 
directory as a backup. If you reinstall or upgrade repeatedly, the files are overwritten each time. 


The gwia.cfg file is the Internet Agent configuration file that contains startup switches. Some 
switches are set during installation. You can set others as needed. For more information, see 
“Using Internet A gent Startup Switches” in “Internet Agent” in the GroupWise 6.5 Administration 
Guide. 


Only the Windows Internet A gent actually uses the gwia.cfg file under the domain. The NetWare 
Internet Agent uses the gwia.cfg file created in sys:\system during installation. The Linux Internet 
Agent uses the gwia.cfg file created in /opt/novell/groupwise/agents/share during installation. On 
NetWare and Linux, the gwia.cfg file under the domain is just a boilerplate file with no switches 
set during installation. 


The route.cfg file enables you to customize routing for specific hosts. For more information, see 
“Using a Route Configuration File” in “Internet Agent” in the GroupWise 6.5 Administration 
Guide. 


The gwauth.cfg file enables the Internet Agent to log in to SMTP hosts that require authentication. 
For more information, see “Configuring SMTP Host Authentication” in “Internet Agent” in the 
GroupWise 6.5 Administration Guide. 


The mimetype.cfg file enables you to customize MIME content-type mappings for various 
attachment types. For more information, see “Customizing MIME Content-Type Mappings” in 
“Internet Agent” in the GroupWise 6.5 Administration Guide 


The exepath.cfg file is used by ConsoleOne to locate the gwia.cfg file. This enables ConsoleOne 
to write any configuration setting changes to the gwia.cfg file or update Novell® eDirectory™ with 
any changes from the file. The file must contain the path to the gwia.cfg file in the sys:\system 
directory on NetWare, the /opt/novell/groupwise/agents/share directory on Linux, or the 
domain\wpgate\gwia directory on Windows. 


The gwac.db file is the access control database that stores information about the classes of service 
you have created. For more information, see “Maintaining the Access Control Database” in 
“Internet Agent” in the GroupWise 6.5 Administration Guide. 
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gwac.dc file 


preamble.txt file 


preamble.all file 


blocked.txt file 


The gwac.dc file is the data dictionary file from which the gwac.db is created. 


The preamble.txt file is an ASCII text file that is automatically included with any MIME multipart 
message and is displayed when the message recipient lacks a MIME-compliant mail reader. For 
more information, see “Customizing MIME Preamble Text” in “Internet Agent” in the GroupWise 
6.5 Administration Guide. 


The preamble.all file contains the preamble text in multiple languages. For more information, see 
“Customizing MIME Preamble Text” in “Internet Agent” in the GroupWise 6.5 Administration 
Guide. 


The blocked.txt file contains a list of Internet sites that you have added to the Prevent Messages 
From list for your default class of service in ConsoleOne. For more information, see “Controlling 
User Access” in “Internet Agent” in the GroupWise 6.3 Administration Guide. 


gwia.mib file (NetWare only) 


statusxx.xml file 


gwia directory 


send directory 


The gwia.mib file contains all the Trap, Set, and Get variables used for communication between 
the Internet Agent and SNMP management consoles. For setup instructions, see “Monitoring the 
Internet Agent through an SNMP Management Console ” in “Internet Agent” in the GroupWise 

6.5 Administration Guide. 


The statusxx.xml file enables you to customize the messages that users receive regarding message 
delivery status. For more information, see “Customizing Delivery Status Notifications” in 
“Internet Agent” in the GroupWise 6.5 Administration Guide. 


The gwia directory is the SMTP service (daemon) home directory where messages are converted 
between GroupWise format and Internet format. On NetWare and Linux, the default location is 
wpgate/gwia, the same as the Internet Agent home directory. On Windows, the default location is 
the Internet Agent installation directory. You can change the location using the /dhome startup 
switch in the Internet Agent configuration file (gwia.cfg). 


The Internet Agent SMTP service places outbound messages in the send directory after they have 
been converted out of GroupWise format into SMTP format. The SMTP service polls the send 
directory and sends any messages to the destination SMTP host. 
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receive directory 


result directory 


defer directory 


dsnhold directory 


help directory 


The Internet Agent SMTP service places inbound messages in the receive directory, converts them 
into Group Wise format, and then passes them to the Message Transfer Agent by placing them in 
the wpcsin directory. 


When the Internet Agent SMTP service processes the message, it builds a file, r*.*, in the result 
directory that contains several lines of comments and SMTP reply codes, which might indicate 
possible errors or confirm correct transmission. After the Internet Agent SMTP service has 
completed the transmission with the destination host, it moves another file, s*.* from the send 
directory to the result directory. The filenames for both files are identical, except for the first letter, 
which is either “s” or “r”. The s*.* file is the converted message file. The SMTP service looks at 
the “s” and “r” files in the result directory and compares the conversation. If the r*.* file contains 
the correct (250 OK) SMTP reply codes, the SMTP service deletes the file and sends a transferred 


status message to the user’s Sent Items folder in the Group Wise client. 


The defer directory holds messages that are deferred and re-queued according to the Retry 
Schedule. If the Internet Agent SMTP service receives a temporary error, such as Host Down, it 
places the message in the defer directory for a specified time, then transfers the file to the send 
directory for another attempt at sending to the Internet. For more information, see “Configuring 
Basic SMTP/MIME Settings” in “Internet Agent” in the GroupWise 6.5 Administration Guide. 


The DSN hold directory stores header information for inbound messages that request delivery 
status notifications. For more information, see “Using Extended SMTP (ESMTP) Options” in 
“Internet Agent” in the GroupWise 6.5 Administration Guide. 


The help directory holds the help files that you can view from the Internet Agent Web console. See 
“Monitoring the Internet Agent through the Web Console” in “Internet Agent” in the GroupWise 
6.5 Administration Guide. 
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WebAccess Agent Queue Directory 
The following directories and files are found under the \domain\wpgate\ structure for the 
WebAccess Agent after the software has been installed and the WebAccess Agent has processed 


messages. 


E domain\wpgate\webac65a GroupWise WebAccess Agent home directory 


[| 000.prc 


E mmddweb.nnn 


Es wpcsin 
07 

Es) wpcsout 
E webxxxx 

@ 07 

T problem 

T gwhold 

Bal gwprob 

E files 

da] template 


J commgr.cfg 
J comint.cfg 
E mimetype.cfg 


J gwcache.db 


WebAccess Agent log file processing directory 


WebAccess Agent log files 


MTA input queue directory 


Message priority subdirectories 


MTA output queue 
System-defined directory for the WebAccess Agent 
Message priority subdirectories 


Hold directory for damaged outbound messages 


Hold directory for delayed delivery messages 


Hold directory for damaged inbound messages 


Directory for documents attached to messages 


Directory for templates for viewing documents 


Communications Manager configuration file 
Communications initialization configuration file 


MIME encoding configuration file for various file types 


Database catalog of documents in the files directory 


LJ gwac.db Access control database 


LJ gwac.dc Database dictionary file used to create the gwac.db file 


domain\wpgate\webac65a directory 


The domain\wpgate\webac65a directory is the WebAccess Agent home directory where 
WebAccess Agent configuration files and queue directories are located. The name is established 
when you install the WebAccess Agent. The default is wpgate\webac65a in the domain directory. 
You can change the location using the /home startup switch in the WebAccess Agent configuration 
file (webac65a.waa in the WebAccess Agent installation directory) if you want to move the 
WebAccess Agent home directory. 


000.prc directory 
The NetWare and Windows WebAccess Agents use the 000.prc directory to store log files. 


On Linux, the 000.pre directory is located under /var/log. 


86 GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 


mmddlog.nnn file 


The mmddlog.nnn files hold error and status messages about the functioning of the WebAccess 
Agent. The WebAccess Agent creates a log file each day with a unique name, where mm is the 
month, dd is the day, and nnn is a sequential number indicating the sequence of log files in a single 
day. For more information about log files, see “Controlling WebAccess Agent Logging” in 
“WebAccess” in the GroupWise 6.5 Administration Guide. 


wpcsin directory 


No longer used. The WebAccess Agent and the MTA communicate by way of TCP/IP and do not 
need queue directories. 


wpcsout directory 


webxxxx directory 


problem directory 


No longer used. 


No longer used. 


No longer used. 


gwhold directory 


No longer used. 


gwprob directory 


files directory 


No longer used. 


The files directory holds documents that are cached after they have been viewed. The gwcache.db 
file keeps track of what documents are available in the files directory. You can configure the 
maximum amount of disk space you want the cached documents to consume. See “Configuring 
the WebPublisher Application” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


template directory 


The template directory holds the HTML templates used for viewing documents in HTML format. 


commgr.cfg file 


The commgr.cfg file in the WebAccess Agent queue directory contains information for 
communication between the WebAccess Agent and the WebAccess Application, including the IP 
address and port where the WebAccess Agent is running, the number of threads that are running, 
and the encryption key for the WebAccess Agent. This communications information is gathered 
during installation. For more information, see “Configuring the GroupWise Service Provider” in 
“WebAccess” in the GroupWise 6.5 Administration Guide. 
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comint.cfg file 


As part of the installation process, the commgr.cfg file is automatically copied to the Web server 
installation (sys:\novell\webaccess on NetWare, /opt/novell/groupwise/webaccess on Linux, and 
c:\novell\webaccess on Windows). The copies are synchronized automatically by the WebAccess 
Application. The commer.cfg file is also copied to the webpublisher subdirectory on the Web 
server. 


The comint.cfg file in the WebAccess Agent queue directory is read by the WebAccess Agent on 
startup. It contains the same communications information as the commegr.cfg file and is 
synchronized with it automatically. 


mimetype.cfg file 


The mimetype.cfg file enables you to customize MIME content-type mappings for various 
attachment types. The WebAccess Agent handles this just as the Internet Agent does. For more 
information, see “Customizing MIME Content-Type Mappings” in “Internet Agent” in the 
GroupWise 6.5 Administration Guide 


gwcache.db file 


gwac.db file 


gwac.dc file 


The gwcache.db file is like a catalog of documents in the files directory. When a user requests a 
document, WebAccess checks gwcache.db and if the document is already in the files directory, it 
can be quickly returned to the user. If the document is not yet in gwcache.db, it is retrieved, 
recorded in gwcache.db, converted for display in HTML format, and then returned to the user. 


The gwac.db file is the access control database that stores information about the classes of service 
you have created. For more information, see “Maintaining the Access Database” in “WebAccess” 
in the GroupWise 6.5 Administration Guide. 


The gwac.dc file is the data dictionary file from which the gwac.db is created. 
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Caching Mailbox Directory 


i) \novel\groupwise\gwXxxxxxx 
ds rofdata 


LJ msg.db 
L user.db 
= wprof.db 
J wprof.dc 


J ngwguard.db 
E ngwguard.dc 
J ngwguard.rfl 

O ngwguard.fok 


LJ puxxxxx.db 


LJ ngwcheck.db 
LJ gwcheckn.log 


LJ remoten.log 


[| gwdms 
LÌ dmsh.db 
LÌ dmxxnn01-ff.db 
Es) docs 
Es) index 


de index 
Es wpcsin 
0-7 
Es wpesoutlofs 
BN 07 


Es) wpgwsend 
E wpgwrecv 


\novel\groupwise\gwxxxxxx directory 


GroupWise Caching mailbox 
Caching mailbox database directory 


Cached message database 
Cached user database 
Cached Address Book 


Data dictionary for cached Address Book 


Guardian database 
Data dictionary for guardian database 
Guardian database roll forward log 


Guardian database “fall back” file 
Database for shared folders 


GroupWise Check database 
Log file created by the Repair Mailbox feature 


Connection log 


Document Management Services directory 

Shared DMS database 

Document databases 

Subdirectory for documents in the Caching mailbox 


QuickFinder index for documents in the Caching mailbox 
QuickFinder index for messages in the Caching mailbox 


Input queue for the Caching mailbox 


Priority subdirectories 


Output queue for the Caching mailbox 


Priority subdirectories 


Output queue to the Online mailbox 


Input queue from the Online mailbox 


Your GroupWise Caching mailbox is a directory structure that functions similarly to a post office. 
Like a post office, it contains databases and input/output queues. It is created in the directory where 
the GroupWise client is installed, which is typically \novell\groupwise. 
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The same directory structure is used for a Caching mailbox as for a Remote mailbox. However, a 
Caching mailbox is a complete copy of your Online mailbox, while you can restrict what gets 
downloaded into your Remote mailbox. 


rofdata directory 


msg.db file 


user.db file 


wprof.db file 


wprof.dc file 


ngwguard.db file 


ngwguard.dc file 


ngwguard.rfl file 


The rofdata directory contains the databases accessed by the GroupWise Windows client when 
running in Caching mode. The databases in rofdata are similar to the databases found in post 
offices. For comparison, see “Post Office Directory” on page 64. 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some naming conventions 
were originally preserved for backward compatibility. 


The msg.db file is the cached equivalent of the msgnn.db files in the ofmsg directory in your post 
office. The msg.db file contains copies of messages from your Online mailbox. 


The user.db file is the cached equivalent of the userxxx.db files in the ofuser directory in your post 
office. 


The wprof.db file contains the cached version of the GroupWise Address Book. 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the wprof in wprof.db. Some naming 
conventions have been preserved for backward compatibility. 


The wprof.dc file is the data dictionary for the cached Address Book (wprof.db). 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the wprof in wprof.dc. Some naming 
conventions have been preserved for backward compatibility. 


The ngwguard.db file is the guardian database for your Caching mailbox. It is parallel in function 
to the ngwguard.db file in the post office. 


The ngwguard.dc file is the data dictionary for building the databases in the GroupWise Caching 
mailbox. It is parallel in function to the ngwguard.dc file in the post office. 


The ngwguard.rfl file is a roll-forward transaction log of every database transaction that has taken 
place since the last copy of the ngwguard.fbk file was created. It is parallel in function to the 
ngwguard.rfl file in the post office. 
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ngwguard.fbk 


puxxxxx.db files 


ngwcheck.db file 


gwcheckn.log 


remoten.log 


gwdms directory 


The ngwguard.fbk file “fall back” copy of the ngwguard.db file. It is parallel in function to the 
ngwguard.fbk file in the post office. 


The puxxxxx.db files are databases for replicated items such as shared folders. These databases 
prevent conflicts between user names of shared items from users in other post offices and user 
names in your own post office. They are parallel to the puxxxxx.db files in the post office. 


The ngwcheck.db file tracks GroupWise Check threads and the databases being checked. In the 
Group Wise client, GroupWise Check is run using Tools > Repair Mailbox. 


The gwcheckn.log file records any errors that occurred during mailbox repair. For assistance with 
GroupWise Check errors, see “GroupWise Check Error Codes” in “Administration Error 
Messages” in the GroupWise 6.5 Troubleshooting 1: Error Messages. 


The remoten.log files in the connection output queue (wpcsout\ofs) are saved versions of the 
connection logs you can view in the GroupWise client by clicking Accounts > Connection Log. 
These log files can be useful for troubleshooting problems with your connection to your Online 
mailbox. 


The gwdms directory is the Document Management Services directory. It contains information 
about the libraries in your GroupWise system. It has the same structure as the gwdms subdirectory 
in the post office. 


dmsh.db file 


The dmsh.db file is a database shared by all libraries that contains a list of all available libraries 
and lookup tables for each library. 


dmxxnn01-ff.db files 


The dmxxnn01-ff-db files are databases for library and document information. They are parallel to 
the dmxxnn01-ff-db files in the post office. 


docs directory 


The docs directory holds cached copies of the documents in your Online mailbox. 


index directory 


The index directory under the gwdms directory contains the QuickFinder index for the documents 
in your Caching mailbox. 
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index directory 


The index directory under the rofdata directory contains the QuickFinder index for the messages 
in your Caching mailbox. 


wpcsin directory 


The wpcsin subdirectory is the input queue for the connection that transfers messages to your 
GroupWise system for delivery. Messages from the GroupWise client in Caching mode are 
processed through the priority 1 subdirectory of wpcsin. 


When you send a message in Caching mode, the GroupWise client connects to your GroupWise 
system. It polls the wpcsin\1 directory and compresses any outgoing messages, requests, or both 
into a file. If the compressed file totals over 50 KB, additional compressed files are created. The 
Group Wise client then moves the compressed files into the wpgwsend directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory name wpcsin for the input queue, although the 
MTA is not involved in processing messages in your Caching mailbox. Some naming conventions 
were originally preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection input queue (wpcsin) parallel those found in the 
wpcsin directory in your post office. 


wpcsoutiofs directory 


The wpcsout\ofs directory is the output queue for the connection that transfers messages from your 
Online mailbox. Messages from your Group Wise system are processed through the priority 1 
subdirectory of wpcsout\ofs. 


The Group Wise client scans the wpcsout\ofs\1 subdirectory and updates the user.db and msg.db 
files with the information received from your Online mailbox. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory names wpcsin and ofs for the input queue, 
though the MTA is not involved in processing messages in your Remote mailbox. Some naming 
conventions were originally preserved for backward compatibility. 


0-7 directories 
The priority 0-7 subdirectories in the connection output queue (wpcsout\ofs) parallel those found 
in the ofs directory in your post office. 

wpgwsend directory 


The wpgwsend directory holds compressed files that contain outgoing messages, requests, or both. 
When a connection to your GroupWise system is established, the GroupWise client uploads the 
files to your Online mailbox. 
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Historical Note: WP Office Remote, the predecessor of GroupWise Remote, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwsend. Some naming 
conventions were originally preserved for backward compatibility. 


wpgwrecv directory 


The wpgwrecv directory holds compressed files that contain messages or other information that 
have been received from your Online mailbox. The GroupWise client decompresses the files and 
places the message files into the wpcsout\ofs\1 directory. 


Historical Note: WP Office Remote, the predecessor of GroupWise Remote, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwrecv. Some naming 
conventions were originally preserved for backward compatibility. 


Remote Mailbox Directory 


2 remote_mailbox GroupWise Remote mailbox 
3 wpcsin Input queue for GroupWise Remote 
ey 0-7 Priority subdirectories 
E rofdata Remote database directory 
J msg.db Remote message database 
_] user.db Remote user database 
J wprof.db Remote Address Book 
LI wprof.dc Data dictionary for Remote Address Book 
LJ ngwguard.db Remote guardian database 
J ngwguard.dc Data dictionary for Remote guardian database 
LI puxxxxx.db Database for shared folders 
Es gwdms Document Management Services directory 
LÌ dmsh.db Shared DMS database 
Es index QuickFinder index for Remote mailbox 
2 wpgwsend Output queue to master mailbox 
Es) wpgwrecv Input queue from master mailbox 
sal wpcsoutiofs Output queue for GroupWise Remote 
El 0-7 Priority subdirectories 
Lj remoten.log Remote connection log 


remote_mailbox directory 


The GroupWise remote mailbox is a directory structure that functions similarly to a post office. 
Like a post office, it contains databases and input/output queues. 
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wpcsin directory 


0-7 directories 


The wpcsin subdirectory in the remote mailbox directory is the input queue for the connection that 
will transfer messages to your master GroupWise system. Messages from Group Wise Remote are 
processed through the priority 1 subdirectory of wpcsin. 


When the user initiates the connection to the master GroupWise system, GroupWise Remote polls 
the wpcsin\1 directory and compresses the outgoing messages, requests, or both into a file. If the 
compressed file totals over 50 KB, additional compressed files are created. GroupWise Remote 
then moves the compressed files into the wpgwsend directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory name wpcsin for the input queue, although the 
MTA is not involved in processing messages in your Remote mailbox. Some naming conventions 
were originally preserved for backward compatibility. 


The priority 0-7 subdirectories in the connection input queue (wpcsin) in the remote mailbox 
directory parallel those found in the wpcsin directory in the remote user's post office on the master 
GroupWise system. 


rofdata directory 


msg.db file 


user.db file 


wprof.db file 


The rofdata subdirectory in the remote mailbox directory contains the databases accessed by 
GroupWise Remote. The databases in rofdata are similar to the databases found in post offices. 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some naming conventions 
were originally preserved for backward compatibility. 


The msg.db file in the remote data directory (rofdata) in the remote mailbox directory is the remote 
equivalent of the msgrn.db files in the ofmsg directory in the post office where your master 
mailbox is located. The msg.db file contains messages you have downloaded from your master 
mailbox. 


The user.db file in the remote data directory (rofdata) in the remote mailbox directory is the remote 
equivalent of the userxxx.db files in the ofuser directory in the post office where your master 
mailbox is located. The user.db file contains user information you have downloaded from your 
master mailbox. 


The wprof.db file in the remote data directory (rofdata) in the Remote mailbox directory contains 
the remote version of the GroupWise Address Book if you have downloaded it. 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the wprof in wprof.db. Some naming 
conventions have been preserved for backward compatibility. 
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wprof.dc file 


ngwguard.db file 


ngwguard.dc file 


puxxxxx.db files 


gwdms directory 


The wprof.dc file in the remote data directory (rofdata) in the Remote mailbox directory is the data 
dictionary for the remote Address Book (wprof.db). 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the wprof in wprof.dc. Some naming 
conventions have been preserved for backward compatibility. 


The ngwguard.db file in the remote data directory (rofdata) in the Remote mailbox directory is the 
guardian database for the GroupWise Remote mailbox. It is parallel in function to the newguard. db 
file in the post office. 


The ngwguard.dc file in the remote data directory (rofdata) in the Remote mailbox directory is the 
data dictionary for building the databases in the GroupWise Remote mailbox. It is parallel in 
function to the ngwguard.dc file in the post office. 


The puxxxxx.db files in the remote data directory (rofdata) in the Remote mailbox directory are 
databases for replicated items such as shared folders. These databases prevent conflicts between 
user names of shared items from users in other post offices and user names in the Remote user’s 
post office. They are parallel to the puxxxxx.db files in the post office. 


The gwdms subdirectory in the remote data directory (rofdata) in the remote mailbox directory is 
the Document Management Services directory. It contains the document libraries you have 
downloaded from your master GroupWise system. It has the same structure as the gwdms 
subdirectory in the post office. 


dmsh.db file 


The dmsh.db file in the remote document management subdirectory (gwdms) in the remote 
mailbox directory is a database shared by all libraries that have been downloaded to your 
GroupWise Remote mailbox. It contains a list of all available libraries and lookup tables for each 
library. 


index directory 


The index directory in the remote document management subdirectory (gwdms) in the remote 
mailbox directory contains the QuickFinder index for the documents contained in the library. 


wpgwsend directory 


The wpgwsend subdirectory in the remote mailbox directory holds compressed files that contain 
outgoing messages, requests, or both. When a connection to your master GroupWise system is 
established, GroupWise Remote uploads the files across the link. 
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Historical Note: WP Office Remote, the predecessor of GroupWise Remote, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwsend. Some naming 
conventions were originally preserved for backward compatibility. 


wpgwrecv directory 


The wpgwrecv subdirectory in the Remote mailbox directory holds compressed files that contain 
messages or other information that have been downloaded from your master mailbox. Group Wise 
Remote decompresses the files and places the message files into the wpcsout\ofs\1 directory. 


Historical Note: WP Office Remote, the predecessor of GroupWise Remote, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the name wpgwrecv. Some naming 
conventions were originally preserved for backward compatibility. 


wpcsoutlofs directory 


0-7 directories 


remoten.log 


The wpcsout\ofs subdirectory in the remote mailbox directory is the output queue for the 
connection that transfers messages from your master GroupWise system. Messages from 
Group Wise Remote are processed through the priority 1 subdirectory of wpcsout\ofs. 


Group Wise Remote scans the wpcsout\ofs\1 subdirectory and updates the user.db and msg.db files 
with the information received from the master mailbox. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named 
the Connection Server (CS). Hence, the directory names wpcsin and ofs for the input queue, 
though the MTA is not involved in processing messages in your Remote mailbox. Some naming 
conventions were originally preserved for backward compatibility. 


The priority 0-7 subdirectories in the connection output queue (wpcsout\ofs) in the remote mailbox 
directory parallel those found in the ofs subdirectory in the remote user's post office on the master 
GroupWise system. 


The remoten.log files in the connection output queue (wpcsout\ofs) in the remote mailbox 
directory are saved versions of the connection logs you can view in Group Wise Remote. These log 
files can be useful for troubleshooting problems with your modem or with your connection to your 
master GroupWise system. 
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Agent Installation Directories 


+ “GroupWise Agent Installation (POA and MTA)” on page 97 


+ “Internet Agent Installation” on page 107 


+ “WebAccess Agent Installation” on page 113 


+ “Monitor Agent Installation” on page 123 


+ “Apache/Tomcat Installation” on page 127 


GroupWise Agent Installation (POA and MTA) 


The Post Office Agent (POA) and the Message Transfer Agent (MTA) are always installed 


together. The agent installation directory differs depending on the platform where the agents are 


installed. 


+ “NetWare Installation Directory” on page 97 


+ “Linux Installation Directory” on page 100 


+ “Windows Installation Directory” on page 105 


NetWare Installation Directory 


E] sys:\system 


J gwenn4.nlm 
LJ gwpoa.nim 


J gwmta.nim 


LJ strtupxx.poa 
LJ strtupxx.mta 


| post_office.poa 


LJ domain.mta 


_] gwpoanxx.hlp 
LJ gwmtanxx.hlp 


LJ gwpoanxx.fil 


LJ gwmtanxx.fil 


Ll grpwise.ncf 


NetWare® agent installation directory 


GroupWise® 6.5 Agent Engine 
Post Office Agent (POA) program 
Message Transfer Agent (MTA) program 


Boilerplate POA startup file 
Boilerplate MTA startup file 


POA startup file for a specific post office 


MTA startup file for a specific domain 


POA online help files 
MTA online help files 


POA language information files 


MTA language information files 


Agent load file 
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L] x*10.nlm XIS NLM™ programs 


O agent.xml XIS agent configuration files 

J gwtsa.nlm GroupWise Target Service Agent (GWTSA) program 

J gwtsaxx.fil GWTSA language information files 

L] gwtsa.ncf GWTSA load file 

LJ gwtmstmp.nlm GroupWise Time Stamp program 

E help Subdirectory for GroupWise agent Web console help files 


NetWare agent installation directory 


gwenn4.nIm file 


gwpoa.nim file 


gwmta.nIm file 


When you first install GroupWise Administration, the GroupWise agents are initially installed in 
platform-specific subdirectories in the agent directory in the software distribution directory. 
However, the agents cannot be run from this initial location. They must be installed on the servers 
where they will run. 


On a NetWare® server, the GroupWise agents are typically installed in the sys:\system directory. 
You can choose a different location during installation. 


The gwenn4.nlm file is the GroupWise 6 Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 


+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


The gwpoa.nlm file is the Post Office Agent program. You load this NLM program to start the Post 
Office Agent. See “Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


The gwmta.nlm is the Message Transfer Agent program. You load this NLM program to start the 
Message Transfer Agent. See “Starting the MTA” in “Message Transfer Agent” in the GroupWise 
6.5 Administration Guide. 
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strtupxx.poa file 


strtupxx.mta file 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne®. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post_office.POA, is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 6.5 Administration Guide. 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.MTA, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the 
GroupWise 6.5 Administration Guide. 


nlm_agentnxx.hlp files 


Online help is available by pressing F1 at the agent console on the server where it runs. See “Using 
the POA Agent Console” in “Post Office Agent” and “Using the MTA Agent Console” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide 


The first five characters of the filename are the agent name. The digit n is a version number. The 
last two characters xx are a language code. 


nlm_agentnxx.fil files 


grpwise.ncf file 


x*10.nlm files 


nim_agent.xml files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The digit n is a version number. The last two 
characters xx are a language code. 


The grpwise.ncf file is the NetWare configuration file that automatically loads the agents 
whenever the server is restarted. A typical grpwise.ncf file would look similar to the following: 


load sys:\system\gwmta.nlm @corpdom.mta 
load sys:\system\gwpoa.nlm @acctpo.poa 


For more information, see “Starting the NetWare POA” in “Post Office Agent” and “Starting the 
NetWare MTA” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The x*10.nlm programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 


The n/m_agent.xml files are specialized agent configuration files for use in the XIS environment. 
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gwtsa.nim file 


gwtmstmp.nIm file 


gwtsaxx.fil file 


gwtsa.ncf file 


help directory 


The gwtsa.nlm is the GroupWise Target Service Agent (GWTSA), which provides reliable 
backups of a running GroupWise system by successfully backing up open files and locked files, 
rather than skipping them as some backup software does. For more information, see “Group Wise 
Target Service Agent ” in “Databases” in the GroupWise 6.5 Administration Guide. 


If you use the Group Wise Target Service Agent (GWTSA) to back up your GroupWise system, the 
time stamping is an automatic part of the backup process. However, if you choose not to use the 
GWTSA, you must still make sure that user databases are time-stamped so that items will not be 
prematurely purged. The gwtmstmp.nlm accomplishes this task. For more information, see 
“Group Wise Time Stamp Utility” in “Databases” in the GroupWise 6.5 Administration Guide. 


These files contain all language-specific information for the GWTSA. The last two characters, xx, 
are a language code. 


The gwtsa.ncf file is the NetWare configuration file that automatically loads the GWTSA 
whenever the server is restarted. A typical gwtsa.ncf file would look similar to the following: 


load sys:\system\smdr 
load sys:\system\gwtsa /home-sys:\gwsystem\corpdom 
/home-sys:\gwsystem\acctpo 


The help directory contains language-specific subdirectories for the help files available from the 
POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and 
“Using the MTA Web Console” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Linux Installation Directory 


3 /opt/novell/groupwise/agents Linux agent installation directory 


dal bin Subdirectory for GroupWise agent executables 
úl gwpoa Post Office Agent (POA) executable 
J gwmta Message Transfer Agent (MTA) executable 
J gwpoa.xml POA XIS configuration file 
LJ gwmta.xml MTA XIS configuration file 
J strtupxx.poa Boilerplate POA startup file 
J strtupxx.mta Boilerplate MTA startup file 
LJ gwesrgen GroupWise Generate CSR utility 
J gwtmstmp GroupWise Time Stamp utility 
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BD ib 
J gwpoaxxx.fil 
LJ gwmtaxxx. fil 


LJ libpoa.so* 
ol libpoa_ui.so* 
L libmta.so* 
J libmta_ui.so* 
Ll *.so* 
$ image 
[| share 

LJ post_office.poa 
L] domain.mta 
Es) agtcon 

de help 


Ea webcon 
Es help 


E Jetc/init.d 
J grpwise 
Ea rc3.d 
LJ S99grpwise 


ee) rc5.d 
Ll S99grpwise 


En /var/log/ 


3] novell/groupwise 


Es post_office.poa 


LJ mmddpoa.nnn 


EN) domain.mta 


J mmddmta.nnn 


de /var/opt/novell/groupwise/log 
LJ mmddlog.nnn 


Subdirectory for GroupWise agent library files 
POA language information file 


MTA language information file 


POA shared library files 
POA shared library files for the optional user interface 
MTA-specific library files 
MTA-specific library files for the optional user interface 


Supporting library files 
Subdirectory for icon images 


Subdirectory for agent shared files 
POA startup file for a specific post office 


MTA startup file for a specific domain 


Subdirectory for agent console files 


Subdirectory agent console help files 


Subdirectory for agent Web console files 


Subdirectory for agent Web console help files 


Standard Linux location for application startup scripts 


Startup script for the POA and MTA 


Standard Linux location for run-level-3 symbolic links 


Symbolic link to the startup script for the POA and MTA 


Standard Linux location for run-level-5 symbolic links 


Symbolic link to the startup script for the POA and MTA 


Standard Linux location for application log files 


Subdirectory for GroupWise agent log files 


Post office-specific subdirectory for POA log files 
POA log files 


Domain-specific subdirectory for MTA log files 
MTA log files 


Location for script log files 


Log file for the agent startup script (grpwise) 
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agents directory 


bin directory 


lib directory 


On a Linux server, the agents are always installed in subdirectories of /opt/novell/groupwise/ 
agents. 


The bin directory holds GroupWise executable files. 


gwpoa file 


The gwpoa file is the Post Office Agent executable. You run this executable file to start the Post 
Office Agent. See “Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


gwmta file 


The gwmta file is the Message Transfer Agent executable. You run this executable file to start the 
Message Transfer Agent. See “Starting the MTA” in “Message Transfer Agent” in the GroupWise 
6.5 Administration Guide. 


* xml files 


The agent.xml files are specialized agent configuration files for use in the XIS environment. 


strtupxx.poa file 


The strtupxx.poa file is the boilerplate file from which a post office-specific post_office.poa file is 
created in the share directory. The xx in the startup filename represents a two-letter language code. 


strtupxx.mta file 


The strtupxx.mta file is the boilerplate file from which a domain-specific domain.poa file is created 
in the share directory. The xx in the startup filename represents a two-letter language code. 


gwesrgen file 


The gwesrgen file is the Group Wise Generate CSR utility. If you enable SSL for the agents, they 
need access to a server certificate and private key. You can use the GroupWise Generate CSR 
utility (GWCSRGEN) to generate a Certificate Signing Request (CSR) file and a Private Key file. 
For more information, see “Server Certificates and SSL Encryption” in “Security” in the 
GroupWise 6.5 Administration Guide. 


gwtmstmp file 


The gwtmstmp file is the GroupWise Time Stamp utility. If you deselect Allow Purge of Items Not 
Backed Up in ConsoleOne, user databases (userxxx.db) must be time-stamped every time a backup 
is performed so that items can be purged only after being backed up. You can use the GroupWise 
Time Stamp (GWTMSTMP) utility to ensure that Group Wise user databases include the dates 
when they were last backed up, restored, and retained. For more information, see “Group Wise 
Time Stamp Utility” in “Databases” in the GroupWise 6.5 Administration Guide. 


The lib directory holds GroupWise library files. 
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share directory 


letc/init.d directory 


* fil files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The last two characters xx are a language code. 


*.so* files 


These files are Linux library files that provide information to the Group Wise agent executables. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


post_office.poa 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. 


During installation, a customized version of the strtupxx.poa file, named post_office.poa, is created 
in the share directory. This customized version has the --home startup switch automatically set to 
the post office directory the POA will service. See “Using POA Startup Switches” in “Post Office 
Agent” in the GroupWise 6.5 Administration Guide. 


domain.mta 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. 


During installation, a customized version of the strtupxx.mta file, named domain.mta, is created in 
the share directory. This customized version has the --home startup switch automatically set to the 
domain directory the MTA will service. See “Using MTA Startup Switches” in “Message Transfer 
Agent” in the GroupWise 6.5 Administration Guide. 


agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. 
See “Using the POA Agent Console” in “Post Office Agent” and “Using the MTA Agent Console” 
in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. See “Using the POA Web Console” in “Post Office Agent” and “Using the MTA Web 
Console” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The /etc/init.d directory is the standard location for Linux startup scripts. 


grpwise file 


The grpwise script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the POA and MTA. For more information about 
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starting the agents, see “Installing and Starting the GroupWise Linux Agents” in “Installing a 
Basic GroupWise System” in the GroupWise 6.5 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 3 (multi-user; boots to a text mode login prompt without The X Window 
System). The symbolic link to the grpwise script is S99grpwise. It is created if you choose during 
installation to have the agents start automatically when the server boots. See “Starting the Linux 
POA” in “Post Office Agent” and “Starting the Linux MTA” in “Message Transfer Agent” in the 
GroupWise 6.5 Administration Guide. 


rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 5 (multi-user; boots to The X Window System login dialog box). The 
symbolic link to the grpwise script is S99grpwise. It is created if you choose during installation to 
have the agents start automatically when the server boots. See “Starting the Linux POA” in “Post 
Office Agent” and “Starting the Linux MTA” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Ivar/log/novell/groupwise directory 


The /var/log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell/groupwise subdirectory. 


post_office.poa directory 
The post_office.poa directory is a post office-specific location for POA log files. 


Within the post_office.poa directory, the POA creates log files (mmddpoa.nnn) to inform you of its 
processing and any problems it encounters. For more information about log files, see “Using POA 
Log Files” in “Post Office Agent” in the GroupWise 6.5 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of 
the month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa.002 is the second POA log file created on May 18. 


domain.mta directory 
The domain.mta directory is a domain-specific location for MTA log files. 


Within the domain.mta directory, MTA creates log files (mmddxxx.nnn) to inform you of its 
processing and any problems it encounters. For more information about log files, see “Using MTA 
Log Files” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of 
the month; the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518mta.002 is the second MTA log file created on May 18. 


Ivar/opt/novell/groupwise/log directory 


The /var directory is used for various types of files. The log file for the agent startup script is 
created in the opt/novell/groupwise/log subdirectory. 
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mmddlog.nnn 


The mmddlog.nnn file stores messages from the agent startup script (grpwise) as it tries to start the 


GroupWise agents. 
Windows Installation Directory 


de c:\grpwise 


LJ gwenv1a.dll 
E gwpoa.exe 


LJ gwmta.exe 


LJ strtupxx.poa 
| strtupxx.mta 


J post_office.poa 


_] domain.mta 


J gwpoanxx.chm 


Ll gwmtanxx.chm 


J gwpoanxx.dll 
J gwmtanxx.dll 


LJ gwsnmp.dll 
LÌ gwwww1.dll 
L x*10.dll 


LJ agent.xml 


Es help 


c:\grpwise 


Windows agent installation directory 


GroupWise Agent Engine 
Post Office Agent (POA) program 
Message Transfer Agent (MTA) program 


Boilerplate POA startup file [need post.poa] 


Boilerplate MTA startup file [need domain.mta] 


POA startup file for a specific post office 


MTA startup file for a specific domain 


POA online help file 
MTA online help file 


POA language information files 


MTA language information files 
Customized DLL program for SNMP 
Customized DLL program for MIME 
XIS DLL programs 

XIS agent configuration files 


Subdirectory for GroupWise agent Web console help files 


When you first install Group Wise Administration, the GroupWise agents are initially installed in 
platform-specific subdirectories in the agent directory. However, the agents cannot be run from 
this initial location. They must be installed on the servers where they will run. 


On a Windows server, the GroupWise agents can be installed in any directory you choose. The 
default is c:\grpwise. The agent icons are set up to include the full path to whatever directory you 


choose. 


gwenv1a.dll file 


The gwenvla.dll file is the GroupWise A gent Engine, a program that is shared by both GroupWise 
agents. It provides the following services to the agents: 


+ Database management 


+ File operations 
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gwpoa.exe file 


gwmta.exe file 


gwsnmp.dil file 


gwwww1.dll file 


strtupxx.poa file 


strtupxx.mta file 


agentnxx.chm files 


+ Message handling 
+ Thread management 
+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


The gwpoa.exe file is the Post Office Agent program. You run this executable file to start the Post 
Office Agent. See “Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


The gwmta.exe file is the Message Transfer Agent program. You run this executable file to start 
the Message Transfer Agent. See “Starting the MTA” in “Message Transfer Agent” in the 
GroupWise 6.5 Administration Guide. 


The gwsnmp.dll file provides interaction with the Windows SNMP Service, so that you can 
monitor the GroupWise agents using an SNMP monitoring program. 


The gwwww1l.dll file provides parsing of MIME messages received from the Internet. 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post_office.poa, is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 6.5 Administration Guide. 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.MTA, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the 
GroupWise 6.5 Administration Guide. 


Online Help is available by clicking Help in the agent consoles on the server where the agents are 
running. In addition, dialog boxes have a Help button for context-sensitive Help. 
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The first five characters of the filename are the agent name. The digit n is a version number. The 
last two characters xx are a language code. 


agentnxx.dll files 


The agentnxx.dll files contain all language-specific information for the agents. The digit n is a 
version number. The last two characters xx are a language code. 


x*10.dll files 
The x*10.dll programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 

agent.xml files 


The agent.xml files are specialized agent configuration files for use in the XIS environment. 


help directory 


The help directory contains language-specific subdirectories for the help files available from the 
POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and 
“Using the MTA Web Console” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Internet Agent Installation 


+ “NetWare Installation Directory” on page 107 
+ “Linux Installation Directory” on page 109 


+ “Windows Installation Directory” on page 112 


NetWare Installation Directory 


E sys:\system NetWare Internet Agent installation directory 
LJ gwenn4.nlm GroupWise 6.5 Agent Engine 
J gwia.nlm Internet Agent NLM program 
LJ gwia.cfg Internet Agent configuration file 
J gwianxx.fil Internet Agent language information file 
J gwia.ncf Internet Agent load file 
L x*10.nim XIS NLM programs 
LJ gwia.xml XIS Internet Agent configuration file 
E help Subdirectory for GroupWise agent console help files 


See also “Internet Agent Queue Directory” on page 80. 
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NetWare Internet Agent installation directory 


gwenn4.nIm file 


gwia.nIm file 


gwia.cfg file 


gwianxx.fil files 


gwia.ncf file 


x*10.nlm files 


On a NetWare server, the GroupWise Internet Agent is typically installed in the sys:\system 
directory. You can choose a different location during installation. 


The gwenn4.nlm file is the GroupWise 6.x Agent Engine, a program that is shared by all 
GroupWise agents. It provides the following services to the agents: 


+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


The gwia.nlm file is the Internet Agent program. You load this NLM program to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 6.5 Installation Guide. 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch 
settings placed in the Internet Agent startup file override comparable options set for the Internet 
Agent in ConsoleOne. The startup file is named the same as the Internet Agent object in 
ConsoleOne. The default is gwia. 


During installation, a customized version of the Internet Agent startup file is created in 
sys:\system. This customized version has the /home startup switch automatically set to the domain 
directory where the Internet Agent’s queue directories are located. See “Using Internet Agent 
Startup Switches” in “Internet Agent” in the GroupWise 6.5 Administration Guide. 


This file contains all language-specific information for the Internet Agent. The digit n is a version 
number. The last two characters xx are a language code. 


The gwia.ncf file is the NetWare configuration file that automatically loads the Internet Agent 
whenever the server is restarted. A typical gwia.ncf file would look similar to the following: 


load sys:\system\gwia @gwia.cfg 


The x*10.nlm programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 
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gwia.xml file 


The gwia.xml file is a specialized Internet Agent configuration file for use in the XIS environment. 


Linux Installation Directory 


3 /opt/novell/groupwise/agents Linux agent installation directory 


E bin 

LJ gwia 

LJ gwia.xml 
Dip 

J gwiaxxx.fil 


LJ libgwia.so 
LJ libgwia_ui.so 
_]*so 


EA] image 


A share 
LJ gwia.cfg 
Es) agtcon 
Es] help 


B webcon 
de help 


E Jetc/init.d 
J grpwise-ia 
ln rc3.d 
O S99grpwise-ia 
En rco.d 
J S99grpwise-ia 


el /var/log/ 
E novell/groupwise 


EA] domain.gwia 


LJ mmddgwia.nnn 


Subdirectory for GroupWise agent executables 
Internet Agent executable 


Internet Agent XIS configuration file 


Subdirectory for GroupWlse agent library files 


Internet Agent language information file 


Internet Agent shared library file 
Internet Agent user interface shared library file 


Supporting shared library files 
Subdirectory for icon images 


Subdirectory for agent shared files 


Internet Agent configuration file 


Subdirectory for agent console files 


Subdirectory agent console help files 


Subdirectory for agent Web console files 


Subdirectory for agent Web console help files 


Standard Linux location for application startup scripts 


Startup script for the Internet Agent 


Standard Linux location for run-level-3 symbolic links 


Symbolic link to the startup script for the Internet Agent 


Standard Linux location for run-level-5 symbolic links 


Symbolic link to the startup script for the Internet Agent 


Standard Linux location for application log files 


Subdirectory for GroupWise agent log files 


Domain-specific subdirectory for Internet Agent log files 


Internet Agent log files 
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agents directory 


bin directory 


lib directory 


share directory 


See also “Internet Agent Queue Directory” on page 80. 


On a Linux server, the Internet Agent is always installed in subdirectories of /opt/novell/ 
groupwise/agents. 


The bin directory holds GroupWise executable files. 
gwia file 


The gwia file is the Internet Agent executable. You run this executable file to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the Group Wise Internet Agent” in the 
GroupWise 6.5 Installation Guide. 


gwia.xml file 


The gwia.xml file is a specialized configuration file for use in the XIS environment. 


The lib directory holds GroupWise shared library files. 


gwiaxxx.fil files 


This file contains all language-specific information for the Internet Agent. The last two characters 
xx are a language code. 


* so files 


These files are Linux shared library files that provide information to the Internet Agent executable. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


gwia.cfg 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch 
settings placed in the Internet Agent configuration file override comparable configuration options 
set for the Internet Agent in ConsoleOne. The startup file is named the same as the Internet Agent 
object in ConsoleOne. The default is gwia. 


During installation, the Internet Agent startup file is created in the share directory with the --home 
startup switch automatically set to the domain directory where the Internet Agent queue directory 
is located. See “Using Internet Agent Startup Switches” in “Internet Agent” in the GroupWise 6.5 
Administration Guide. 
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letc/init.d directory 


agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 


The /etc/init.d directory is the standard location for Linux startup scripts. 


grpwise-ia file 


The grpwise script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the Internet Agent. For more information about 
starting the Internet Agent, see “Starting the Internet Agent” in “Installing the GroupWise Internet 
Agent” in the GroupWise 6.5 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 3 (multi-user; boots to a text mode login prompt without The X Window 
System). The symbolic link to the grpwise-ia script is S99grpwise-ia. It is created if you choose 
during installation to have the Internet Agent start automatically when the server boots. 


rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 5 (multi-user; boots to The X Window System login dialog box). The 
symbolic link to the grpwise-ia script is S99grpwise-ia. It is created if you choose during 
installation to have the Internet Agent start automatically when the server boots. 


Ivar/log/novell/groupwise directory 


The /var/log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell/groupwise subdirectory. 


domain.gwia directory 
The domain.gwia directory is a domain-specific location for Internet Agent log files. 


Within the domain.gwia directory, the Internet Agent creates log files (mmddgwia.nnn) to inform 
you of its processing and any problems it encounters. For more information about log files, see 
“Using Internet Agent Log Files” in “Internet Agent” in the Group Wise 6.5 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of 
the month. The three-digit extension is a sequence number for multiple log files created on the 
same day. For example, 0518gwia.002 is the second Internet Agent log file created on May 18. 
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Windows Installation Directory 


c:\grpwise\gwia 


gwenv1a.dll file 


gwia.exe file 


gwia.cfg file 


Es c:\grpwise\gwia Windows Internet Agent installation directory 
Ll gwenv1a.dll GroupWise Agent Engine 
J gwia.exe Internet Agent program 
LJ gwia.cfg Internet Agent configuration file 
LJ gwianxx.chm Internet Agent online help file 
J gwianxx.dll Internet Agent language information file 
J gwwww1.dll Customized DLL program for MIME 
_] x*10.dll XIS DLL programs 
J gwia.xml XIS agent configuration file 


See also “Internet Agent Queue Directory” on page 80. 


On a Windows server, the Internet Agent can be installed in any directory you choose. The default 
location is c:\grpwise\gwia. The Internet Agent icon is set up to include the full path to whatever 
directory you choose. 


The gwenvla.dll file is the GroupWise Agent Engine, a program that is shared by both Group Wise 
agents. It provides the following services to the agents: 


+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


The gwia.exe file is the Internet Agent program. You run this executable file to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 6.5 Installation Guide. 


On Windows, the gwia.cfg file in the installation directory is simply a pointer to the gwia.cfg file 
under the domain directory where the actual Internet Agent configuration file is located. 
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gwianxx.chm files 


Online help is available by clicking Help in the Internet Agent console on the server where the 
agent is running. In addition, dialog boxes have a Help button for context-sensitive Help. 


The digit n is a version number. The last two characters xx are a language code. 


gwianxx.dll files 


The gwianxx.dll files contain all language-specific information for the Internet Agent. The digit n 
1s a version number. The last two characters xx are a language code. 


gwwww1.dll file 


The gwwww1l.dll file provides parsing of MIME messages received from the Internet. 


x*10.dil files 


The x*10.dll programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 


gwia.xml file 


The gwia.xml file is a specialized agent configuration file for use in the XIS environment. 


WebAccess Agent Installation 


+ “NetWare Installation Directory” on page 113 


+ “Linux Installation Directory” on page 115 


+ “Windows Installation Directory” on page 120 


NetWare Installation Directory 


E sys:\system 


LJ gwenn4.nlm 
J gwinter.nlm 
LÌ strtweb.ncf 


L] webac65a.waa 


J x*10.nlm 


LJ gwinter.xml 


Es cache\template\xx 
J webacc.tpt 
L] publish.tpt 


ES) help 


NetWare WebAccess Agent installation directory 


GroupWise 6.5 Agent Engine 
WebAccess Agent program 


WebAccess Agent load file 
WebAccess Agent startup file 


XIS NLM programs 


XIS Internet Agent configuration file 


Subdirectory for HTML template files 
WebAccess template files 


WebPublisher template files 


Subdirectory for GroupWise agent console help files 
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Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See “Apache/Tomcat Installation” on page 127. See also 
“WebAccess Agent Queue Directory” on page 86. 


NetWare Internet Agent installation directory 


gwenn4.nIm file 


gwinter.nIm file 


strtweb.ncf 


webac65a.waa file 


On a NetWare server, the GroupWise WebAccess Agent is typically installed in the sys:\system 
directory. You can choose a different location during installation. 


The gwenn4.nlm file is the GroupWise 6.x Agent Engine, a program that is shared by all 
Group Wise agents. It provides the following services to the agents: 


+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


The gwinter.nlm file is the WebAccess Agent program. 


The strtweb.ncf file is the NetWare configuration file that automatically loads the WebAccess 
Agent whenever the server is restarted. A typical strtweb.ncf file would look similar to the 
following: 


load sys:\system\gwinter @webac65a.waa 


It includes the WebAccess Agent startup file in the load command. For more information, see 
“Starting GroupWise WebAccess” in “Installing GroupWise WebAccess” in the GroupWise 6.5 
Installation Guide. 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess Agent startup file override comparable options set for the 
WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent 
object in ConsoleOne. The default is webac65a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where 
the WebAccess Agent’s queue directories are located. See “Using WebAccess Agent Startup 
Switches” in “WebAccess” in the GroupWise 6.5 Administration Guide. 
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x*10.nlm files 


The x*10.nlm programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 


gwinter.xml file 


The gwinter.xml file is a specialized WebAccess Agent configuration file for use in the XIS 


environment. 


cache\template\xx directory 


The cache\template\xx directory holds language-specific HTML template files for viewing 


documents in WebAccess and WebPublisher. The xx is a two-letter language code. 


You can change the location of the cache directory, as described in “Modifying WebPublisher 
Settings” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


help directory 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Monitoring the WebAccess Agent through the Web Console” in “WebAccess” in the GroupWise 


6.5 Administration Guide. 


Linux Installation Directory 


3 /opt/novell/groupwise 
Es agents 
E bin 
J gwinter 
J gwinter.xml 


L] webac65axx.waa 
Dib 

_]*so 

E image 
E share 


LJ webac65a.waa 


E webcon 
de help 


EA] webaccess 


Novell GroupWise installation directory 
Linux agent installation directory 


Subdirectory for GroupWise agent executables 
WebAccess Agent executable 
WebAccess Agent XIS configuration file 


Boilerplate WebAccess startup file 


Subdirectory for GroupWise agent library files 
Supporting shared library files 


Subdirectory for icon images 


Subdirectory for agent shared files 


Domain-specific WebAccess Agent startup file 


Subdirectory for agent Web console files 


Subdirectory for agent Web console help files 


Subdirectory for WebAccess Application files 
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agents directory 


J webacc.cfg 
J commgr.cfg 
J spellchk.cfg 
J Idap.cfg 
E default 

E logs 


El users 
E webpublisher 


J webpub.cfg 


ol commgr.cfg 
Es default 
E logs 


T cache\template\xx 
LJ webacc.tpt 
L publish.tpt 


E Jetc/init.d 
L grpwise-wa 
Ta rc3.d 
J S99grpwise-wa 


Es) rc5.d 
_] S99grpwise-wa 


dl /var/log/ 


E] novell/groupwise 


de domain.webac65a 
E 000.prc 


LJ mmddgwia.nnn 


WebAccess Application configuration file 
Communications Manager configuration file 
Novell Speller Application configuration file 
LDAP service provider configuration file 
Subdirectory for boilerplate configuration files 
Subdirectory for WebAccess Application log files 


Subdirectory for users’ WebAccess session information 
Subdirectory for WebAccess Application files 


WebPublisher Application configuration file 
Communications Manager configuration file 
Subdirectory for boilerplate configuration files 


Subdirectory for WebPublisher Application log files 


Subdirectory for HTML template files 
WebAccess template files 


WebPublisher template files 


Standard Linux location for application startup scripts 


Startup script for the WebAccess Agent 


Standard Linux location for run-level-3 symbolic links 


Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for run-level-5 symbolic links 


Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for application log files 


Subdirectory for GroupWise agent log files 


Domain-specific subdirectory for WebAccess Agent log files 
Processing directory for log files 


WebAccess Agent log files 


Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See “Apache/Tomcat Installation” on page 127. See also 
“WebAccess Agent Queue Directory” on page 86. 


On a Linux server, the WebAccess Agent is always installed in subdirectories of /opt/novell/ 
groupwise/agents. 
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bin directory 


lib directory 


share directory 


The bin directory holds GroupWise executable files. 


gwinter file 


The gwinter file is the WebAccess Agent executable. You run this executable file to start the 
WebAccess Agent. See “Setting Up GroupWise WebAccess on Linux” in “Installing GroupWise 
WebAccess” in the GroupWise 6.5 Installation Guide. 


gwinter.xml file 


The gwinter.xml file is a specialized configuration file for use in the XIS environment. 


webac65axx.waa file 


The webac6axx.waa file is the boilerplate file from which a domain-specific webac65a.waa file is 
created in the share directory. The webac65a represents the name of the WebAccess Agent object 
in eDirectory. The xx represents a two-letter language code. 


The lib directory holds GroupWise shared library files. 


* so files 


The *.so files are Linux shared library files that provide information to the WebAccess Agent 
executable. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


webac65a.waa 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess Agent startup file override comparable options set for the 
WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent 
object in ConsoleOne. The default is webac65a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where 
the WebAccess Agent’s queue directories are located. See “Using WebAccess Agent Startup 
Switches” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 
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webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 


The webacc.cfg file holds the same configuration information that is stored on the WebAccess 
Application object (named GroupWiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 6.5 Administration 
Guide. 


commgr.cfg file 


The commgr.cfg file holds the same configuration information that is stored on the Group Wise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address and 
encryption key for the WebAccess Agent. This information enables the WebAccess Application to 
communicate with the WebAccess Agent. For more information, see “Configuring the Group Wise 
Service Provider” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain/wpgate/webac6S5a). 


spellchk.cfg file 


The spellchk.cfg file holds the same configuration information that is stored on the Novell Speller 
Application object (named NovellSpeller) in eDirectory. For more information, see “Configuring 
the Novell Speller Application” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


Idap.cfg file 


The Idap.cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


default directory 


The default directory holds boilerplate versions of the various .cfg files. 


logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted 
or goes down, users do not lose the message text they were composing at the time. Session files 
are deleted when users log back in. 


webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 
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letc/init.d directory 


webpub.cfg 


The webpub.cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named Group WiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


commgr.cfg file 


The commgr.cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named Group WiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain/wpgate/webac6S5a). 


default directory 


The default directory holds boilerplate versions of the webpub.cfg and commgr.cfg files. 


logs directory 


The logs subdirectory holds WebPublisher Application log files. For more information, see 
“Controlling WebPublisher Application Logging” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


cache\template\xx directory 


The cache\template\xx directory holds language-specific HTML template files for viewing 
documents in WebAccess and WebPublisher. The xx is a two-letter language code. 


You can change the location of the cache directory, as described in “Modifying WebPublisher 
Settings” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


The /etc/init.d directory is the standard location for Linux startup scripts. 
grpwise-wa file 


The grpwise-wa script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the WebAccess Agent. For more information 
about starting the WebAccess Agent, see “Setting Up GroupWise WebAccess on Linux” in 
“Installing GroupWise WebAccess” in the GroupWise 6.5 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 3 (multi-user; boots to a text mode login prompt without The X Window 
System). The symbolic link to the grpwise-wa script is S99grpwise-wa. It is created if you choose 
during installation to have the WebAccess Agent start automatically when the server boots. 
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rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 5 (multi-user; boots to The X Window System login dialog box). The 
symbolic link to the grpwise-wa script is S99grpwise-wa. It is created if you choose during 
installation to have the WebAccess Agent start automatically when the server boots. 


Ivar/log/novell/groupwise directory 


The /var/log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell/groupwise subdirectory. 


domain.webac65a directory 


The domain.webac6S5a directory is a domain-specific location for WebAccess Agent log files. 


000.prc directory 


Within the 000.prc directory, the WebAccess Agent creates log files (mmddweb.nnn) to inform 
you of its processing and any problems it encounters. For more information about log files, see 
“Controlling WebAccess Agent Logging” in “WebAccess” in the GroupWise 6.5 Administration 
Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of 
the month. The three-digit extension is a sequence number for multiple log files created on the 
same day. For example, 0518web.002 is the second WebAccess Agent log file created on May 18. 


Windows Installation Directory 


Es] c:\webacc Windows WebAccess Agent installation directory 
J gwenv1a.dll GroupWise Agent Engine 
O gwinter.exe WebAccess Agent program 
LÌ strtweb.bat WebAccess Agent batch file 
L] webac65a.waa WebAccess Agent startup file 
Ll gwwanxx.dll WebAccess Agent language information file 
1 gwwasnmp.dil Customized DLL program for SNMP 
1 gwwww1 il Customized DLL program for MIME 
L] x*10.dll XIS DLL programs 
E gwinter.xml XIS agent configuration file 


E cache\template\xx Subdirectory for HTML template files 


LJ webacc.tpt WebAccess template files 
J publish.tpt WebPublisher template files 
3 help Subdirectory for GroupWise agent console help files 
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c:\webacc 


gwenv1a.dll file 


gwinter.exe file 


strtweb.bat file 


webac65a.waa file 


Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See “Apache/Tomcat Installation” on page 127. See also 
“WebAccess Agent Queue Directory” on page 86. 


On a Windows server, the WebAccess Agent can be installed in any directory you choose. The 
default location is c:\webacc. The WebAccess Agent desktop icon is set up to include the full path 
to whatever directory you choose. 


The gwenvla.dll file is the GroupWise Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 


+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


The gwinter.exe file is the WebAccess Agent program. 


The strtweb.bat file is used to start the WebAccess Agent. The batch file specifies the WebAccess 
startup file. A typical strtweb.bat file includes the following: 


title Novell GroupWise WebAccess 
@echo off 

cls 

gwinter.exe @webac65a.waa 


You run this batch file to start the WebAccess Agent. See “Starting Group Wise WebAccess” in 
“Installing GroupWise WebAccess” in the GroupWise 6.5 Installation Guide. 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess A gent startup file override comparable configuration options set 
for the WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess 
Agent object in eDirectory. The default is webac65a. 


During installation, the WebAccess Agent startup file is created with the /home startup switch 
automatically set to the domain directory where the WebAccess Agent queue directory 
(domain\wpgate\webac65a) is located. See “Using WebAccess Agent Startup Switches” in 
“WebAccess” in the GroupWise 6.5 Administration Guide. 
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gwwanxx.dll files 


gwwasnmp.dil file 


gwwww1.dll file 


x*10.dil files 


gwinter.xml file 


The gwwanxx.dll files contain all language-specific information for the WebAccess Agent. The 
digit n is a version number. The last two characters xx are a language code. 


The gwwasnmp.dll file provides interaction with the Windows SNMP Service, so that you can 
monitor the WebAccess Agent using an SNMP monitoring program. This file is not installed 
unless you enable SNMP during installation. It cannot be installed if the SNMP Service is not 
installed on the Windows server. 


The gwwww1l.dll file provides parsing of MIME messages received from the Internet. 


The x*10.dll programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 


The gwia.xml file is a specialized agent configuration file for use in the XIS environment. 


cache\template\xx directory 


help directory 


The cache\template\xx directory holds language-specific HTML template files for viewing 
documents in WebAccess and WebPublisher. The xx is a two-letter language code. 


You can change the location of the cache directory, as described in “Modifying WebPublisher 
Settings” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Monitoring the WebAccess Agent through the Web Console” in “WebAccess” in the Group Wise 
6.5 Administration Guide. 
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Monitor Agent Installation 


+ “Linux Installation Directory” on page 123 


+ “Windows Installation Directory” on page 125 


Linux Installation Directory 


Es /opt/novell/groupwise 
[| agents 
T bin 
Jj gwmon 
D iib 
J * SO 
a share 
J monitor.xml 


©) gwmonitor 


LJ gwmonitor.cfg 
En default 

ey logs 

E users 


E Jetc/init.d 
Ll grpwise-ma 
Es) rc3.d 
LJ S99grpwise-ma 


En rc5.d 
LJ S99grpwise-ma 


E! /var/log/ 
Es) novell/groupwise 
de] gwmon 
L] mmddmon.nnn 


LJ mmadhist.nnn 


GroupWise installation directory 
Linux agent installation directory 


Subdirectory for GroupWise agent executables 


Monitor Agent executable 


Subdirectory for GroupWise agent library files 
Supporting shared library files 


Subdirectory for agent shared files 


Monitor Agent configuration file 
Subdirectory for Monitor Application files 


Monitor Application configuration file 
Subdirectory for boilerplate configuration files 
Subdirectory for Monitor Application log files 


Directory for Monitor users’ session files 


Standard Linux location for application startup scripts 


Startup script for the Monitor Agent 


Standard Linux location for run-level-3 symbolic links 


Symbolic link to the startup script for the Monitor Agent 


Standard Linux location for run-level-5 symbolic links 


Symbolic link to the startup script for the Monitor Agent 


Standard Linux location for application log files 


Subdirectory for GroupWise agent log files 


Subdirectory for Monitor Agent log files 
Monitor Agent event log files 


Monitor Agent history log files 
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agents directory 


bin directory 


lib directory 


share directory 


On a Linux server, the Monitor Agent is always installed in subdirectories of /opt/novell/ 
groupwise/agents. 


The bin directory holds GroupWise executable files. 


gwmon file 


The gwmon file is the Monitor Agent executable. You run this executable file to start the Monitor 
Agent. See “Starting the Monitor Agent” in “Monitor” in the GroupWise 6.5 Administration 
Guide. 


The lib directory holds GroupWise shared library files. 


* so files 


These files are Linux shared library files that provide information to the Monitor Agent 
executable. 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


monitor.xml file 


The monitor.xml file is a specialized configuration file for use in the XIS environment. 


gwmonitor directory 


The gwmonitor directory holds files used by the Monitor Application. 


gwmonitor.cfg file 


The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 
Application object (named Group WiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 6.5 Administration Guide. 


default directory 


The default directory holds boilerplate versions of the gwmonitor.cfg file and the monitor.xml file. 


logs directory 


The logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 6.5 Administration Guide. 


users directory 


The users subdirectory holds session files for Monitor users. 
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letc/init.d directory 


The /etc/init.d directory is the standard location for Linux startup scripts. 


grpwise-ma file 


The grpwise-ma script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the Monitor Agent. For more information about 
starting the Monitor Agent, see “Starting the Monitor Agent” in “Monitor” in the GroupWise 6.5 
Administration Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 3 (multi-user; boots to a text mode login prompt without The X Window 
System). The symbolic link to the grpwise-ma script is S99grpwise-ma. It is created if you choose 
during installation to have the Monitor Agent start automatically when the server boots. 


rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to run level 5 (multi-user; boots to The X Window System login dialog box). The 
symbolic link to the grpwise-ma script is S99grpwise-ma. It is created if you choose during 
installation to have the Monitor Agent start automatically when the server boots. 


Ivar/log/novell/groupwise directory 


The /var/log directory is the standard location for log files on Linux. All GroupWise agent log files 
are created in the novell/groupwise subdirectory. 


gwmon directory 


Within the gwmon directory, the Monitor Agent creates two different types of log files. The 
mmddmon.nnn log files inform you of its processing and any problems it encounters. The 
mmddhist.nnn log files record dumps of all MIB values gathered during each poll cycle. For more 
information about log files, see “Configuring Monitor Agent Log Settings” in “Monitor” in the 
GroupWise 6.5 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of 
the month. The three-digit extension is a sequence number for multiple log files created on the 
same day. For example, 0518mon.002 is the second Monitor Agent log file created on May 18. 


Windows Installation Directory 


Ea] c:\gwmon Windows Monitor Agent installation directory 
LJ gwenv1a.dll GroupWise Agent Engine 
LJ gwmon.exe Monitor Agent program 
LÌ monitor.xml Monitor Agent configuration file 
J gwmonxx.dll Monitor Agent language information file 
LJ gwsnmp.dll Customized DLL program for SNMP 
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c:\gwmon 


gwenv1a.dll file 


gwmon.exe file 


monitor.xml 


gwmonxx.dll files 


gwsnmp.dll file 


L] x*10.dll XIS DLL programs 


J gwmon.xml XIS agent configuration file 


am. 


Z monwork Monitor Agent working directory 


Additional Monitor files are integrated into your Web server to support the Monitor Web console. 
For an example, see “Apache/Tomcat Installation” on page 127. 


On a Windows server, the Monitor Agent can be installed in any directory you choose. The default 
location is c:\gwmon. The Monitor Agent desktop icon is set up to include the full path to whatever 
directory you choose. 


The gwenvla.dll file is the GroupWise Agent Engine, a program that is shared by all GroupWise 
agents. It provides the following services to the agents: 


+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


The gwmon.exe file is the Monitor Agent program. You run this executable file to start the Monitor 
Agent. See “Starting the Monitor Agent” in “Monitor” in the GroupWise 6.5 Administration 
Guide. 


The monitor.xml file stores the Monitor Agent configuration information that you establish in the 
Monitor Agent console, as described in “Configuring the Monitor Agent” in “Monitor” in the 
GroupWise 6.5 Administration Guide. 


The gwmonxx.dll files contain all language-specific information for the WebAccess Agent.The 
last two characters xx are a language code. 


The gwsnmp.dll file provides interaction with the Windows SNMP Service, so that the Monitor 
Agent can throw SNMP traps. See “Configuring SNMP Trap Notification of Agent Problems” in 
“Monitor” in the GroupWise 6.5 Administration Guide 
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x*10.dll files 
The x*10.dll programs provide XIS capability for the GroupWise agents, so that you can create 
XML documents to monitor and change the agents as needed. 

gwmon.xml file 


The gwmon.xml file is a specialized agent configuration file for use in the XIS environment. 


monwork directory 


The monwork directory is used for temporary files used in calculating system performance, as 
described in “Measuring Agent Performance” in “Monitor” in the GroupWise 6.5 Administration 
Guide 


Apache/Tomcat Installation 


WebAccess, WebPublisher, and Monitor rely on the presence of a Web server in order to fulfil 
their functions. A number of Web servers are supported. See “GroupWise System Requirements” 
in “Installing a Basic Group Wise System” in the GroupWise 6.5 Installation Guide. In this section, 
the Apache Web server and the Tomcat Servlet Engine used to illustrate how GroupWise 
integrates with your Web server. 


+ “NetWare Installation Directory” on page 127 


+ “Linux Installation Directory” on page 133 


NetWare Installation Directory 


Ea] sys:\apache Apache installation directory 
E bin Standard Apache directory 
Es) cgi-bin Standard Apache directory 
3 conf Standard Apache directory 

J httpd.conf Main Apache configuration file 


Ll GWApache2.conf Specialized Apache configuration file for use with GroupWise 


Es) error Standard Apache directory 
3 htdocs Apache document root directory 
L] index.html Web server default Web page 
Es com/novell Directory for Novell product files 
Es collexion Directory for Novell class files and properties files 
E GWMonitor Directory for GroupWise Monitor files 
3 help Subdirectory for Monitor Web console help files 
= images Subdirectory for Monitor Web console image files 
y palm Subdirectory for Monitor Palm* Query Application (PQA) files 
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= images 
+) inso 


E webaccess 
de applets 
ds help 
Es images 
de palm 
Es webconsole 


Es webpublisher 
de help 
dal images 
w icons 
Es) logs 
J man 
Es) manual 
E modules 


E] sys:\tomcat\4 
E pin 
E common 
Es) conf 
E examples 
E] logs 
E server 
Es) shared 
E] temp 


Es) webapps/ROOT 


LU WEB-INF 
J web.xml 


J classes/com/novell 
E] collexion 


Es GWMonitor 
E providers 


Es templates 


Directory for Novell product image files 


Directory for Inso* viewer files for viewing attachments 


Directory for GroupWise WebAccess files 

Subdirectory for WebAccess client properties files 

Subdirectory for WebAccess client help files 

Subdirectory for WebAccess client image files 

Subdirectory for WebAccess PQA files 

Subdirectory for WebAccess Application Web console help files 


Directory for GroupWise WebPublisher files 
Subdirectory for WebPublisher help files 
Subdirectory for WebPublisher image files 


Standard Apache directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 


Tomcat installation directory 
Standard Tomcat directory 
Standard Tomcat directory 
Standard Tomcat directory 
Standard Tomcat directory 
Standard Tomcat directory 
Standard Tomcat directory 
Standard Tomcat directory 


Standard Tomcat directory 
Standard Tomcat directory 


Web server information directory 


Web server configuration file 
Directory for Novell product files 
Directory for language-specific morphology files 


Directory for GroupWise Monitor files 
Subdirectory for service provider files 


Subdirectory for template files 
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E webaccess Directory for GroupWise WebAccess files 


E providers Subdirectory for service provider files 
ol templates Subdirectory for template files 
E webpublisher Directory for GroupWise WebPublisher files 
Es providers Subdirectory for service provider files 
Es templates Subdirectory for template files 


=] work 


E sys:\novell 


E] gwmonitor 


LJ gwmonitor.cfg 


Ate. 


=] logs 


w webaccess 
J webacc.cfg 
J commgr.cfg 
J spellchk.cfg 


Standard Tomcat directory 


Directory for Novell product configuration files 


Subdirectory for GroupWise Monitor 
Monitor Application configuration file 


Directory for Monitor Application log files 


Subdirectory for WebAccess 
WebAccess Application configuration file 
Communications Manager configuration file 


Novell Speller Application configuration file 


úl Idap.cfg LDAP service provider configuration file 

2 logs Directory for WebAccess Application log files 
2 temp Temporary working directory 

2 users Directory for WebAccess users’ session files 


Es) webpublisher 
O webpub.cfg 


Ll commgr.cfg 
| default 


Subdirectory for WebAccess Application files 
WebPublisher Application configuration file 
Communications Manager configuration file 


Subdirectory for boilerplate configuration files 


a logs Subdirectory for WebPublisher Application log files 


conf/httpd.conf file 
The httpd.conf file is the main Apache configuration file. On NetWare 6.5, the GroupWise 
Installation program modifies it to include a reference to the GWApache2.conf file. 
conf/GWApache2.conf file 
The GWApache2.conf file includes the jkmount command that enables Apache and Tomcat to 
communicate with each other. 
htdocs/index.html file 


The index.html file is the default HTML file that displays in your Web browser when you hit the 
IP address or hostname of the server. When you install WebAccess or Monitor, you have the option 
of replacing the default Web page with a Novell-specific Web page. See “Web Server Default 
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Page” in “Installing GroupWise WebAccess” and “Web Server Default Page” in “Installing 
GroupWise Monitor” in the GroupWise 6.5 Installation Guide. 


GWMonitor/palm directory 


The Monitor Installation program gives you the opportunity to create a Palm Query Application 
(PQA) file so that you can monitor the GroupWise agents from any Palm OS device. If you want 
to create a PQA file after initial installation, you can run setup.exe in the \admin\monitor directory 
of your software distribution directory or on the GroupWise 6.5 Administrator CD and use the /pqa 
startup option to create the PQA file without installing GroupWise Monitor. For more information, 
see “Web Clipping Application (PQA) URL” in “Installing GroupWise Monitor” in the 
GroupWise 6.5 Installation Guide and “Creating a PQA File for the Monitor Web Console” in 
“Monitor” in the GroupWise 6.5 Administration Guide. 


webaccess/palm directory 


The WebAccess Installation program gives you the opportunity to create a Palm Query 
Application (PQA) file so that you can use the WebAccess client from any Palm OS device. If you 
want to create a PQA file after initial installation, you can run setup.exe in the \internet\webaccess 
directory of your software distribution directory or on the GroupWise 6.5 Administrator CD and 
use the /pqa startup option to create the PQA file without installing GroupWise WebAccess. For 
more information, see “Web Clipping Application (PQA) URL (NetWare and Windows 
WebAccess)” in “Installing GroupWise WebAccess” in the GroupWise 6.5 Installation Guide and 
“Creating a PQA File for the WebAccess Client” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


WEB-INF/web.xml file 


The web.xml file tells the Web server where the various GroupWise service providers and their 
configuration files are located. By default, they are located in subdirectories under sys:\novell. 


GWMonitor/providers directory 


The providers directory holds the Java* class and properties files for the Monitor provider. For 
more information, see “Adding or Removing Service Providers” in “Monitor” in the GroupWise 
6.5 Administration Guide. 


GWMonitor/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 6.5 Administration Guide. 


webaccess/providers directory 


The providers directory holds the Java class and properties files for the WebAccess providers. For 
more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


webaccess/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebAccess Application Template Settings” 
in “WebAccess” in the GroupWise 6.5 Administration Guide. 
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webpublisher/providers directory 


The providers directory holds the Java class and properties files for the WebPublisher providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


webpublisher/templates directory 
The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebPublisher Application Template 
Settings” in “WebAccess” in the GroupWise 6.5 Administration Guide. 

sys:\novell directory 
The sys:\novell directory holds subdirectories for each Novell product that uses application 
configuration files. 

gwmonitor directory 


The gwmonitor directory is created when you install GroupWise Monitor. 


gwmonitor.cfg file 


The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 
Application object (named Group WiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 6.5 Administration Guide. 


logs directory 


The logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 6.5 Administration Guide. 


webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 


The webacc.cfg file holds the same configuration information that is stored on the WebAccess 
Application object (named GroupWiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 6.5 Administration 
Guide. 


commgr.cfg file 


The commgr.cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named Group WiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain\wpgate\webac6S5a). 
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spellchk.cfg file 


The spellchk.cfg file holds the same configuration information that is stored on the Novell Speller 
Application object (named NovellSpeller) in eDirectory. For more information, see “Configuring 
the Novell Speller Application” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


Idap.cfg file 


The Idap.cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted 
or goes down, users do not lose the message text they were composing at the time. 


webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 


webpub.cfg 


The webpub.cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named GroupWiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


commgr.cfg file 


The commgr.cfg file holds the same configuration information that is stored on the Group Wise 
Provider object (named Group WiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain\wpgate\webac65a). 


default directory 


The default directory holds boilerplate versions of the webpub.cfg and commgr.cfg files. 
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logs directory 


The logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebPublisher Application Logging” in “WebAccess” in the GroupWise 6.5 
Administration Guide. 


Linux Installation Directory 


E /opt/novell/http Novell Apache installation directory 
Es) bin Standard Apache directory 
Es build Standard Apache directory 
Es) doc Standard Apache directory 
Es) logs Standard Apache directory 
E modules Standard Apache directory 


E /etc/opt/novell/http 
E conf 
E conf.d 
de gconf.d 
init 
E logrotate.d 
Es) sslconf.d 


de /etc/opt/novell/tomcat4 
Ll catalina.properties 
LJ jk2.properties 
L] server.xml 
L] tomcat-users.xml 
_] tomcat4.conf 
_] web.xml 
E init 
Es logrotate.d 


Novell Apache configuration directory 


Standard Apache directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 


Novell Tomcat configuration directory 


Standard Tomcat file 
Standard Tomcat file 
Standard Tomcat file 
Standard Tomcat file 
Standard Tomcat file 

Web server configuration file 
Standard Tomcat directory 


Standard Tomcat directory 


2 /var/opt/novell Novell subdirectory under /var 


E gw Apache document root directory for WebAccess and 
WebPublisher 


J index.html Web server default Web page 
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Z] com/novell 
E] collexion 
E] images 
+ inso 
Z] webaccess 
E] applets 
E] help 
— images 
E] webconsole 


Es webpublisher 
E help 
Es images 
T] WEB-INF 
LJ web.xml 


J classes/com/novell 
E] collexion 


Es] webaccess 
Ta providers 
Es templates 


Ea webpublisher 
a providers 
Es templates 


E gwmon 
LJ index.html 


J com/novell 


ra 


Ea gwmonitor 
E help 
E images 
E WEB-INF 
LÌ web.xml 


Es) gwmonitor 
de providers 


Es templates 


Directory for Novell product files 
Directory for Novell class files and properties files 


Directory for Novell product image files 


Directory for Inso viewer files for viewing attachments 


Directory for GroupWise WebAccess files 
Subdirectory for WebAccess client properties files 
Subdirectory for WebAccess client help files 


Subdirectory for WebAccess client image files 


Subdirectory for WebAccess Application Web console help files 


Directory for GroupWise WebPublisher files 
Subdirectory for WebPublisher help files 
Subdirectory for WebPublisher image files 


Web server information directory 


Web server configuration file 
Web server configuration file 
Directory for language-specific morphology files 


Directory for GroupWise WebAccess files 
Subdirectory for service provider files 


Subdirectory for template files 


Directory for GroupWise WebPublisher files 
Subdirectory for service provider files 


Subdirectory for template files 


Apache document root directory for Monitor 


Web server default page 
Directory for Novell product files 


Directory for GroupWise WebPublisher files 
Subdirectory for WebPublisher help files 
Subdirectory for WebPublisher image files 


Web server information directory 


Web server configuration file 


Directory for GroupWise Monitor files 
Subdirectory for service provider files 


Subdirectory for template files 
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gw/index.html file 


a httpd Standard Apache directory 


ig] webapps 


L] admin.xml 
O manager.xml 


E examples 
T gw 


E log Standard Apache directory 
ay noviwww Home directory for the noviwww user created at installation 
| run Standard Apache directory 
w tomcat4 Standard Tomcat directory 
Ta bin Standard Tomcat directory 
E common Standard Tomcat directory 
Bel conf --> /etc/opt/novell/tomcat4 
E logs Standard Tomcat directory 
E server Standard Tomcat directory 
Es) shared Standard Tomcat directory 
3 temp Standard Tomcat directory 


Standard Tomcat directory 
Standard Tomcat file 
Standard Tomcat file 
Standard Tomcat directory 


--> /var/opt/novell/gw 


E gwmon --> /var/opt/novell/gwmon 
Es) tomcat-docs Standard Tomcat directory 
Es) webdav Standard Tomcat directory 


The index.html file in the gw directory is the initial page for accessing the WebAccess client. See 
“Starting GroupWise WebAccess” in the GroupWise 6.5 WebAccess Client User Guide. 


gw/WEB-INF/web.xml file 


The web.xml file in the gw/WEB-INF directory tells the Web server where the various WebAccess 
service providers and their configuration files are located. By default, they are located in /opt/ 
novell/groupwise/webaccess. 


webaccess/providers directory 


The providers directory holds the Java class and properties files for the WebAccess providers. For 
more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


webaccess/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebAccess Application Template Settings” 
in “WebAccess” in the GroupWise 6.5 Administration Guide. 
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webpublisher/providers directory 


The providers directory holds the Java class and properties files for the WebPublisher providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


webpublisher/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebPublisher Application Template 
Settings” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


gwmon/index.html file 


The index.html file in the gwmon directory is the login Web page for GroupWise Monitor if you 
have provided a password as described in “Configuring Authentication and Intruder Lockout for 
the Monitor Web Console” in “Monitor” in the GroupWise 6.5 Administration Guide. See also 
“Using the Monitor Agent Console”. 


gwmon/WEB-INF/web.xml file 


The web.xml file in the gwmon/WEB-INF directory tells the Web server where the Monitor 
service provider and its configuration file are located. By default, they are located in /opt/novell/ 
groupwise/gwmonitor. 


gwmonitor/providers directory 


The providers directory holds the Java class and properties files for the Monitor provider. For more 
information, see “Adding or Removing Service Providers” in “Monitor” in the GroupWise 6.5 
Administration Guide. 


gwmonitor/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 6.5 Administration Guide. 
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Software Distribution Directory 


+ “NetWare/Windows Software Distribution Directory” on page 137 


+ “Linux Software Distribution Directory” on page 143 


NetWare/Windows Software Distribution Directory 


a software_distribution directo Master copy of GroupWise® software 
= ry py p 


Es agents 
L install.exe 
Es) nim 
Es) nt 
E] startups 
E snmp 
E help 


w domain 
LJ wpdomain.dc 
J gwdom.dc 
LJ wphost.dc 
Ll gwpo.dc 

T po 
LJ ngwguard.dc 


LJ wphost.dc 
LJ gwpo.dc 


GroupWise agent software 
GroupWise Agent Installation program 
NetWare® agent software 

Windows agent software 

Agent startup files 

GroupWise MIB files 

Agent Web console help files 


Domain data dictionary files 

Data dictionary for GroupWise 4.x domain databases 

Data dictionary for GroupWise 6.x and 5.x domain databases 
Data dictionary for GroupWise 4.x post office databases 


Data dictionary for GroupWise 6.x and 5.x post office databases 


Post office data dictionary files 
Data dictionary for message store databases 
Data dictionary for GroupWise 4.x post office databases 


Data dictionary for GroupWise 6.x and 5.x post office databases 
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E client 


GroupWise client software 


J setup.cfg GroupWise client installation configuration file 
ol win32 GroupWise client for Windows 
LJ setup.exe GroupWise client installation program 
T addons GroupWise client addon programs 
3 gwmailto Program to make GroupWise your browser e-mail program 
3 gwtip Program to display tips each time GroupWise starts 
E ofviews GroupWise client view files 
3 zen ZENworks supporting files 
E admin GroupWise administrator software 
ay cladmin GroupWise snap-ins to ConsoleOne® 
Es) monitor GroupWise Monitor software 
E utility GroupWise administrative utilities 
Es) gwcheck GroupWise Check utility 


EN] gwesrgen 


GroupWise Generate CSR utility 


E setupip GroupWise TCP/IP Setup utility 
Es) internet Internet connectivity software 
E gwia GroupWise Internet Agent software 


Z] webaccess 


GroupWise WebAccess software 


Y license GroupWise Software License Agreement in multiple languages 
Es) common Java files used by GroupWise programs 
E docs GroupWise Installation Guide 


\grpwise\software directory 


The GroupWise software distribution directory resides initially on the GroupWise distribution CD. 
GroupWise Administration is installed directly from the CD. In addition, during installation, you 
create a software distribution directory on your network from which you subsequently install the 
GroupWise agents and GroupWise client software. 


The default software distribution directory is \grpwise\software. 


agents directory 
The agents subdirectory contains all files associated with GroupWise agents: 
+ Post Office Agent (POA) 
+ Message Transfer Agent (MTA) 
+ GroupWise Target Service Agent (GWTSA) 
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install.exe file 


nim directory 


nt directory 


startups directory 


snmp directory 


help directory 


The install.exe file in the agent subdirectory is the installation program you run to install the 
GroupWise agents on the servers where you will run the POA and/or MTA. For instructions, see 
“Installing and Starting the POA” in “Post Office Agent” and “Installing and Starting the MTA” 
in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The nlm subdirectory in the agent subdirectory contains the GroupWise agent NLM™ files 
installed on NetWare servers. See “NetWare Installation Directory” on page 97. 


The nt subdirectory contains the GroupWise agent files installed on Windows servers. See 
“Windows Installation Directory” on page 105. 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See “NetWare Installation Directory” on page 97 
or “Windows Installation Directory” on page 105. 


The snmp subdirectory contains GroupWise MIB files. For more information, see “Using SNMP 
Monitoring Programs” in “Post Office Agent” and “Message Transfer Agent” in the GroupWise 
6.5 Administration Guide. 


The help directory holds the help files that you can view from the agent Web consoles. See “Using 
the POA Web Console” in “Post Office Agent” and “Using the MTA Web Console” in “Message 
Transfer Agent” in the GroupWise 6.5 Administration Guide. 


domain directory 


wpdomain.dc file 


The domain subdirectory contains the files from which domains are created. 


The wpdomain.dc file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
domain databases (wpdomain.db files) in secondary domains. 


If the wpdomain.dc file is missing from the primary domain, you cannot rebuild Group Wise 4.x 
secondary domains. The original wpdomain.dc file is located in the domain directory of the 
Group Wise distribution media. 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.dc. Some naming 
conventions were originally preserved for backward compatibility. 
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gwdom.dc file 


wphost.dc file 


gwpo.dc file 


po directory 


ngwguard.dc file 


The gwdom.dc file is the distribution copy of the data dictionary for creating and rebuilding 
Group Wise 6.x and GroupWise 5.x domain databases (wpdomain.db files) in secondary domains. 


If the gwdom.dc file is missing from the primary domain, you cannot create or rebuild Group Wise 
6.x/5.x secondary domains. The original gwdom.dc file is located in the domain subdirectory of 
the GroupWise distribution media. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.db. Some naming conventions 
were originally preserved for backward compatibility. 


The wphost.dc file is the distribution copy of the data dictionary for rebuilding Group Wise 4.x post 
office databases (wphost.db files). 


If the wphost.dc file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wphost.dc file is located in the domain subdirectory of the GroupWise 
distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.dc. Some naming conventions were originally preserved for backward compatibility. 


The gwpo.dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 6.x and GroupWise 5.x post office databases (wphost.db files). 


If the gwpo.dc file is missing from a domain, you cannot create or rebuild Group Wise 6.x/5.x post 
offices in that domain. The original gwpo.dc file is located in the domain directory of the 
GroupWise CD. There is also a copy in the po directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.db. Some naming conventions were originally preserved for backward compatibility. 


The po subdirectory contains the files from which post offices are created. 


The ngwguard.dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 


+ ngwguard.db (guardian database) 
+ dmxxnn01-FF (document management databases) 


+ msgnn.db (message databases) 


+ 


userxxx.db (user databases) 


+ puxxxxx.db (databases for replicated items like shared folders) 
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If the ngwguard.dc file is missing from a post office, new databases cannot be created in the post 
office, so the post office cannot grow. The original ngwguard.dc file is located in the po directory 
of the GroupWise CD. 


Group Wise Remote also uses the ngwguard.dc file as the data dictionary for its local databases. 


client directory 
The client subdirectory contains all files associated with GroupWise Windows client. See “Client” 
in the GroupWise 6.5 Administration Guide. 

setup.cfg file 


The setup.cfg file enables you to automate installation of the GroupWise Windows client so that 
your users do not need to respond to the Setup program’s prompts. For more information, see 
“Using a Configuration File to Enable AutoUpdate and to Select Installation Responses” in 
“Client” in the GroupWise 6.5 Administration Guide. 


win32 directory 
The client\win32 subdirectory contains all GroupWise client files installed for use with Windows. 
See “Windows Client” on page 153. 


setup.exe file 


The client\win32\setup.exe file is the program GroupWise client users run to install and set up the 
GroupWise client on their Windows workstations. See “Client” in the GroupWise 6.5 
Administration Guide. 


addons directory 


The addons directory contains subdirectories for programs that can be used along with the 
GroupWise client to enhance aspects of its functionality. 


gwmailto directory 


The gwmailto directory contains a program that makes the GroupWise Windows client the default 
e-mail application in your Web browser. For more information, see “[GWMAILTO]” in 
“Modifying the Configuration File” in “Client” in the GroupWise 6.5 Administration Guide. 


gwtip directory 


The gwtip directory contains a program that display a helpful tip about GroupWise each time the 
client starts. For more information, see “[GWTIP] ” in “Modifying the Configuration File” in 
“Client” in the GroupWise 6.5 Administration Guide. 


ofviews directory 


The client\ofviews subdirectory contains platform-specific subdirectories of view files for use by 
the Group Wise client. In addition, the gwviewxx.ini and ofviewxx.ini files configure custom views 
on the menus where users select views. The gwviewxx.ini file configures GroupWise 6.x and 

GroupWise 5.5 views. The ofviewxx.ini file configures views from earlier versions of GroupWise. 
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zen directory 


The zen directory contains files that let you use ZENworks Desktop Management to distribute the 
GroupWise Windows client to users’ workstations. See “Using ZENworks Desktop Management 
to Distribute the GroupWise Windows Client” in “Client” in the Group Wise 6.5 Administration 
Guide. 


admin directory 


c1admin directory 


monitor directory 


utility directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
Group Wise. 


The admin\cladmin subdirectory contains the GroupWise snap-ins to ConsoleOne. 


The admin\monitor subdirectory contains the GroupWise 6 Monitor program, an SNMP 
monitoring program for use with the GroupWise agents. See “Monitor” in the GroupWise 6.5 
Administration Guide. 


The admin\utility subdirectory contains helpful GroupWise utilities. 


gwcheck directory 


The admin\utility\gwcheck subdirectory contains the GroupWise Check utility. See “GroupWise 
Check” in “Standalone Database Maintenance Programs” in the GroupWise 6.5 Administration 
Guide. 


gwcsrgen directory 


The admin\utility\gwcheck subdirectory contains the Group Wise Generate CSR utility. See 
“Server Certificates and SSL Encryption” in “Security” in the GroupWise 6.5 Administration 
Guide. 


setupip directory 


The admin\utility\setupip subdirectory contains supporting programs for the client AutoUpdate 
feature. See “Enabling AutoUpdate” in “Client” in the GroupWise 6.5 Administration Guide. 


internet directory 


gwia directory 


The internet subdirectory contains subdirectories for GroupWise components that provide Internet 
connectivity. 


The internet\gwia subdirectory contains the GroupWise Internet Agent software, used to connect 
Group Wise systems across the Internet and to allow GroupWise users to exchange e-mail with 
users of various Internet e-mail programs. For information about Internet Agent files and 
directories, see “Internet Agent Queue Directory” on page 80 and “Internet Agent Installation” on 
page 107. 
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For information about the Internet Agent, see “Internet Agent” in the GroupWise 6.5 
Administration Guide. 


webaccess directory 


The internet\webaccess subdirectory contains the GroupWise WebAccess software, which allows 
users to access their GroupWise mailboxes from a Web browser. For information about 
WebAccess files and directories, see “WebAccess Agent Queue Directory” on page 86, 
“WebAccess Agent Installation” on page 113, and “Apache/Tomcat Installation” on page 127 


For information about WebAccess, see “WebAccess” in the GroupWise 6.5 Administration Guide. 


license directory 
The license subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Run license.exe > select a language. 

common directory 


The common subdirectory contains Java files used by various components of GroupWise. 


docs directory 


The docs subdirectory contains language-specific subdirectories for the Installation Guide in PDF 
format. You can find the most up-to-date version of the GroupWise 6.5 Installation Guide on the 
GroupWise 6.5 Documentation Web site (http://www.novell.com/documentation/gw65/ 
index.html). 


Linux Software Distribution Directory 


E /opt/novell/groupwise/software Master copy of GroupWise software 
L install GroupWise Installation script 
E agents GroupWise agent software 
y linux Subdirectory for Linux* software 
J novell-groupwise-agents-ver. date.i386.rpm GroupWise agent package 
E startups Subdirectory for startup files 
E language Language-specific files 
| strtupxx.poa POA startup file 
| strtupxx.mta MTA startup file 
| S99grpwise GroupWise agent startup script (POA and MTA) 
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Es) domain 
J wpdomain.dc 
J gwdom.dc 
LJ wphost.dc 
J gwpo.dc 


E po 
J ngwguard.dc 
J wphost.dc 
LJ gwpo.dc 


E client 
E linux 
LJ install 


LJ novell-groupwise-gwclient-ver.date.i386.rpm 
Es) ofviews 
E admin 
J novell-groupwise-admin-ver.date.i386.rpm 
LJ novell-groupwise-dbcopy-ver.date.i386.rpm 


J novell-groupwise-gwcheck-ver.date.i386.rpm 
J NOVLc1Linuxjre-ver.i386.rpm 


H monitor 
Es linux 
J novell-groupwise-gwmon-ver.date.i386.rpm 
l novell-groupwise-monitor-ver.date.i386.rpm 
Ta startup 
J S99grpwise-ma 


na 


El internet 


Domain data dictionary files 

Data dictionary for GroupWise 4.x domain databases 
Data dictionary for GroupWise 6.x and 5.x domain databases 
Data dictionary for GroupWise 4.x post office databases 
Data dictionary for GroupWise 6.x and 5.x post office 
databases 

Post office data dictionary files 

Data dictionary for message store databases 

Data dictionary for GroupWise 4.x post office databases 
Data dictionary for GroupWise 6.x and 5.x post office 
databases 

GroupWise client software 

Subdirectory for Linux software 

Cross-Platform client installation script 

Cross-Platform client package 


GroupWise client view files 


GroupWise administrator software 
GroupWise snap-ins to ConsoleOne package 
GroupWise Database Copy Utility package 
GroupWise Check Utility package 
ConsoleOne JRE update package 


GroupWise Monitor software 
Subdirectory for Linux software 
Monitor Agent package 
Monitor Application package 
Subdirectory for startup files 


Monitor startup script 


Internet connectivity software 
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ds] gwia 
E linux 
LJ novell-groupwise-gwia-ver.date.i386.rpm 
Es) root 
J gwia.cfg 
Ll gwauth.cfg 
J mimetype.cfg 
LJ gwac.dc 
LJ preamble.txt 
LJ preamble.all 
_] statusxx.xml 
de startup 
J S99grpwise-ia 
w webacces 
Es) linux 
J novell-groupwise-gwinter-ver.date.i386.rpm 
Ll novell-groupwise-webaccess-ver.date.i386.rpm 
Es root 
J mimetype.cfg 
LJ gwac.dc 
J gwgs.ini 
de startup 


LJ S99grpwise-wa 


EN] webserver 
Æ linux 
LJ * rpm 


Z] license 


Z docs 


Es) gwinst 


/opt/novell/groupwise/software directory 


GroupWise Internet Agent software 
Subdirectory for Linux software 
GroupWise Internet Agent package 
Subdirectory for boilerplate supporting files 
Internet Agent startup file 

Host authentication configuration file 

MIME encoding configuration file 
Database dictionary for the access control database 
Message for non-MIME recipients 
Preamble message in various languages 
File for customizing status messages 
Subdirectory for startup files 


Internet Agent startup script 


GroupWise WebAccess software 

Subdirectory for Linux software 

GroupWise WebAccess Agent package 

GroupWise WebAccess Application package 
Subdirectory for boilerplate supporting files 

MIME encoding configuration file 

Database dictionary for the access control database 
Gateway identifier file 

Subdirectory for startup files 

WebAccess Agent startup script 


Web server to support WebAccess and Monitor 
Subdirectory for Linux software 


Apache, Tomcat, and related packages 


GroupWise Software License Agreement in multiple 
languages 


GroupWise Readme, Quick Start, and Installation Guide 


Directories and files used by the Installation program 


The GroupWise software distribution directory resides initially on the GroupWise distribution CD. 
GroupWise Administration is installed directly from the CD. In addition, during installation, you 
can create a software distribution directory on your network from which you subsequently install 
the GroupWise agents and GroupWise client software. 


The default software distribution directory is /opt/novell/groupwise/software. 
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install file 


The install file is the script you use to install all components of GroupWise on Linux. See “Setting 
Up a Basic GroupWise System on Linux” in the GroupWise 6.5 Installation Guide. 


agents directory 


The agents subdirectory contains all files associated with GroupWise agents: 
+ Post Office Agent (POA) 
+ Message Transfer Agent (MTA) 
+ GroupWise Target Service Agent (GWTSA) 


novell-groupwise-agents.version.date.i386.rpm 


startups directory 


The novell-groupwise-agents.version.date.1386.rpm file is the GroupWise agent package that is 
installed by the Installation script. You can install the agent package manually if necessary. To see 
what files are installed by the package, see “Linux Installation Directory” on page 100. 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See “Linux Installation Directory” on page 100. 


S99grpwise file 


The S99grpwise file is the GroupWise agent startup script. During installation, it is named grpwise 
and placed in /etc/init.d. If you choose to have the agents start automatically when the server 
reboots, the Installation script places symbolic links to it named S99grpwise are placed in the rc3.d 
and rc5.d subdirectories of /etc/init.d. For more information, see “Installing and Starting the 
GroupWise Linux Agents” in “Installing a Basic GroupWise System” in the GroupWise 6.5 
Installation Guide. 


domain directory 


wpdomain.dc file 


The domain subdirectory contains the files from which domains are created. 


The wpdomain.dc file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
domain databases (wpdomain.db files) in secondary domains. 


If the wpdomain.dc file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wpdomain.dc file is located in the domain directory of the 
GroupWise distribution media. 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.dc. Some naming 
conventions were originally preserved for backward compatibility. 


146 GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure 


gwdom.dc file 


wphost.dc file 


gwpo.dc file 


po directory 


ngwguard.dc file 


The gwdom.dc file is the distribution copy of the data dictionary for creating and rebuilding 
Group Wise 6.x and GroupWise 5.x domain databases (wpdomain.db files) in secondary domains. 


If the gwdom.dc file is missing from the primary domain, you cannot create or rebuild Group Wise 
6.x/5.x secondary domains. The original gwdom.dc file is located in the domain subdirectory of 
the GroupWise distribution media. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation (WPCorp). Hence, the wp in wpdomain.db. Some naming conventions 
were originally preserved for backward compatibility. 


The wphost.dc file is the distribution copy of the data dictionary for rebuilding Group Wise 4.x post 
office databases (wphost.db files). 


If the wphost.dc file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wphost.dc file is located in the domain subdirectory of the Group Wise 
distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.dc. Some naming conventions were originally preserved for backward compatibility. 


The gwpo.dc file is the distribution copy of the data dictionary for creating and rebuilding 
Group Wise 6.x and Group Wise 5.x post office databases (wphost.db files). 


If the gwpo.dc file is missing from a domain, you cannot create or rebuild Group Wise 6.x/5.x post 
offices in that domain. The original gwpo.dc file is located in the domain directory of the 
Group Wise CD. There is also a copy in the po directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by 
WordPerfect Corporation (WPCorp). Post offices were originally called hosts. Hence, the name 
wphost.db. Some naming conventions were originally preserved for backward compatibility. 


The po subdirectory contains the files from which post offices are created. 


The ngwguard.dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 


+ ngweguard.db (guardian database) 

+ dmxxnn0/-FF (document management databases) 
+ msgnn.db (message databases) 

+ userxxx.db (user databases) 


+ puxxxxx.db (databases for replicated items like shared folders) 
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If the ngwguard.dc file is missing from a post office, new databases cannot be created in the post 
office, so the post office cannot grow. The original ngwguard.dc file is located in the po directory 
of the GroupWise CD. 


Group Wise Remote also uses the ngwguard.dc file as the data dictionary for its local databases. 


client directory 
The client subdirectory contains all files associated with GroupWise Windows client. See “Client” 
in the GroupWise 6.5 Administration Guide. 

install file 


The install file is the script that Group Wise Cross-Platform client users run to install and set up the 
Group Wise client on their Linux or Macintosh* workstations. See “Setting Up the Group Wise 
Cross-Platform Client” in the GroupWise 6.5 Installation Guide. 


novell-groupwise-gwclient-version.date.i386.rpm 


The novell-groupwise-client.version.date.i386.rpm file is the Group Wise client package that is 
installed by the Installation script. You can install the client package manually if necessary. To see 
what files are installed by the package, see “Cross-Platform Client on Linux” on page 156. 


ofviews directory 


The client\ofviews subdirectory contains platform-specific subdirectories of view files for use by 
the GroupWise client. On Linux, the win subdirectory contains the view files for the Windows 
client, so that users on a Linux post office can use the Windows client if desired. The Cross- 
Platform client does not use view files like the Windows client does. 


In addition, the gwviewxx.ini and ofviewxx.ini files configure custom views on the menus where 
users select views in the Windows client. The gwviewxx.ini file configures GroupWise 6.x and 
GroupWise 5.5 views. The ofviewxx.ini file configures views from earlier versions of GroupWise. 


admin directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
Group Wise. 
novell-groupwise-admin-version.date.i386.rpm file 


The novell-groupwise-admin.version.date.i386.rpm file is the GroupWise administrator package 
that is installed by the Installation script. It contains the GroupWise Administrator snap-ins to 
ConsoleOne. You can install the admin package manually if necessary. 


novell-groupwise-dbcopy-version.date.i386.rpm file 


The novell-groupwise-dbcopy.version.date.i386.rpm file is the Group Wise Database Copy utility 
package. It is not installed by the Installation script but must be installed manually, as described 
in “Using DBCopy on Linux Servers” in “Databases” in the Group Wise 6.5 Administration Guide. 
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novell-groupwise-gwcheck-version.date.i386.rpm file 


The novell-groupwise-gwcheck.version.date.1386.rpm file is the GroupWise Check utility 
package. It is not installed by the Installation script but must be installed manually, as described 
in “Starting GWCheck on a Linux Workstation” in “Databases” in the GroupWise 6.5 
Administration Guide. 


NOVLc1Linuxjre-version.i386.rpm file 


monitor directory 


The NOVLcel Linuxjre-version.1386.rpm file is the package that updates ConsoleOne so that it is 
compatible with the GroupWise Administrator snap-ins. It is installed for you automatically when 
you install Group Wise administration. 


The monitor subdirectory contains the GroupWise Monitor software. See “Monitor” in the 
GroupWise 6.5 Administration Guide. 


novell-groupwise-gwmon-version.date.i386.rpm file 


The novell-groupwise-gwmon.version.date.1386.rpm file is the GroupWise Monitor Agent 
package that is installed by the Installation script. You can install the package manually if 
necessary. To see what files are installed by the package, see “Monitor Agent Installation” on 
page 123 and “Apache/Tomcat Installation” on page 127. 


novell-groupwise-monitor-version.date.i386.rpm file 


The novell-groupwise-monitor.version.date.1386.rpm file is the GroupWise Monitor Application 
package that is installed by the Installation script. You can install the package manually if 
necessary. To see what files are installed by the package, see “Monitor Agent Installation” on 
page 123 and “Apache/Tomcat Installation” on page 127. 


S99grpwise-ma file 


The S99grpwise-ma file is the Monitor Agent startup script. During installation, 1t is named 
grpwise-ma and placed in /etc/init.d. If you choose to have the Monitor Agent start automatically 
when the server reboots, the Installation script places symbolic links to 1t named S99grpwise-ma 
in the rc3.d and rc5.d subdirectories of /etc/init.d. For more information, see “Installing the Linux 
Monitor Agent” in “Installing GroupWise Monitor” in the GroupWise 6.5 Installation Guide. 


internet directory 


gwia directory 


The internet subdirectory contains subdirectories for GroupWise components that provide and 
support Internet connectivity. 


The gwia subdirectory contains the Internet Agent software, used to connect GroupWise systems 
across the Internet and to allow GroupWise users to exchange e-mail with users of various Internet 
e-mail programs. See “Internet Agent” in the GroupWise 6.5 Administration Guide. 
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novell-groupwise-gwia-version.date.i386.rpm file 


The novell-groupwise-gwia.version.date.1386.rpm file is the Internet Agent package that is 
installed by the Installation script. You can install the package manually if necessary. To see what 
files are installed by the package, see “Internet Agent Installation” on page 107. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
Internet Agent root directory under the domain directory. For more information, see “Internet 
Agent Queue Directory” on page 80. 


S99grpwise-ia file 


The S99grpwise-ia file is the Internet A gent startup script. During installation, it is named grpwise- 
ma and placed in /etc/init.d. If you choose to have the Internet Agent start automatically when the 
server reboots, the Installation script places symbolic links to it named S99grpwise-ma in the rc3.d 
and rc5.d subdirectories of /etc/init.d. For more information, see “Starting the Internet Agent on 
Linux” in “Installing the GroupWise Internet Agent” in the GroupWise 6.5 Installation Guide. 


webacces directory 


The internet\webacces subdirectory contains the GroupWise WebAccess software, which allows 
users to access their GroupWise mailboxes from a Web browser. See “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


novell-groupwise-gwinter-version.date.i386.rpm file 


The novell-groupwise-gwinter.version.date.i386.rpm file is the WebAccess Agent package that is 
installed by the Installation script. You can install the package manually if necessary. To see what 
files are installed by the package, see “WebAccess Agent Installation” on page 113. 


novell-groupwise-webaccess-version.date.i386.rpm file 


The novell-groupwise-webaccess.version.date.i386.rpm file is the WebAccess Application 
package that is installed by the Installation script. You can install the package manually if 
necessary. To see what files are installed by the package, see “WebAccess Agent Installation” on 
page 113 and “Apache/Tomcat Installation” on page 127. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
WebAccess Agent root directory under the domain directory. For more information, see 
“WebAccess Agent Queue Directory” on page 86. 


S99grpwise-wa file 


The S99grpwise-ia file is the WebAccess Agent startup script. During installation, it is named 
grpwise-ma and placed in /etc/init.d. If you choose to have the Internet A gent start automatically 
when the server reboots, the Installation script places symbolic links to it named S99grpwise-ma 
in the rc3.d and rc5.d subdirectories of /etc/init.d. For more information, see “Setting Up 
GroupWise WebAccess on Linux” in “Installing GroupWise WebAccess” in the GroupWise 6.5 
Installation Guide. 
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webserver directory 


On Linux, you can install Apache and Tomcat along with WebAccess and Monitor. This 
automatically integrates WebAccess and Monitor into Apache and Tomcat for you. If you are 
already running Apache and Tomcat, you can choose to integrate WebAccess and Monitor into that 
installation, or you can have two Apache/Tomcat installations on your server. WebAccess and 
Monitor cannot be used without a supporting Web server. For more information, see “Determining 
the WebAccess and WebPublisher Applications' Configuration” in “Installing GroupWise 
WebAccess” and “Determining the Monitor Application's Configuration” in “Installing 
GroupWise Monitor” GroupWise 6.5 Installation Guide. 


license directory 


docs directory 


The license subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Use the more command to view the License Agreement. 


The docs subdirectory contains language-specific subdirectories for the GroupWise 6.5 
Installation Guide and Quick Start in PDF format, along with the Readme in HTML format. You 
can find the most up-to-date version of the GroupWise documentation on the GroupWise 6.5 
Documentation page (http://www.novell.com/documentation/gw65/index.html). 


gwinst directory 


The gwinst subdirectory contains supporting files and subdirectories used by the Installation 
script. 
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4 0 GroupWise Client Installation Directories 


+ “Windows Client” on page 153 


¢ “Cross-Platform Client on Linux” on page 156 


+ “Cross-Platform Client on Macintosh” on page 158 


Windows Client 


E c:\novell\groupwise 


J grpwise.exe 
LJ gwtip.exe 

J notify.exe 

1 addrbook.exe 


LJ gwcheck.exe 
LJ htrsetup.exe 
LJ gwimpexe.exe 
LJ gwmailto.exe 
J gwreload.exe 


_] gwsync.exe 


LJ ngwguard.dc 
LJ wprof.dc 


all 
L *.0cx 
LJ * fit 
LI * chm 


E ofviews 
E win 
L * vew 
Y + ini 


Installation directory for GroupWise® 6.x Windows client software 


GroupWise client program 
GroupWise Tip of the Day program 
GroupWise Notify program 
GroupWise Address Book program 


GroupWise GWCheck program 
Hit the Road setup program 
GroupWise E-Mail Importer Utility 
Web browser support program 
Mailbox mode switching program 


Mailbox synchronization program 


Data dictionary for databases 


Data dictionary for Remote Address Book 

DLL programs to support GroupWise Windows client 
OLE custom controls 

Graphics filters for Inso viewers 

Help files to support the GroupWise client 


GroupWise view files 
GroupWise view files for Windows 
View files 


View initialization files 


GroupWise Client Installation Directories 


153 


de] ppforms Day planner forms 
J * bfp Form description files 


J * prs Print resource files 


c:\novell\groupwise 


The GroupWise Windows client installation directory contains all files necessary to run the 
GroupWise client. The default location is c:\novell\groupwise. 


¢ For a standard installation, the Group Wise client directory resides on the user’s workstation. 


¢ Fora workstation installation, the GroupWise client directory resides on the network and is 
run by users on many workstations. 


+ For a GroupWise Remote installation, the GroupWise Remote directory contains the same 
files as would be installed on a workstation connected to the network. Whenever Group Wise 
cannot make a network connection, it checks for a GroupWise Remote mailbox to access. See 
“Remote Mailbox Directory” on page 93. 

grpwise.exe file 


The grpwise.exe file is the Group Wise 6.x client program for use with Windows. 


gwtip.exe file 
The gwtip.exe file is the GroupWise Tip of the Day program, which displays helpful information 
about a GroupWise feature each time you start the GroupWise client. 

notify.exe file 


The notify.exe file is the program that alerts you whenever you have incoming items, when your 
outgoing items are opened, or when you have an upcoming appointment. Notify can alert you in 
four ways: a sound, a dialog box, a small icon, or by launching an application. 


addrbook.exe file 


The addrbook.exe file is the program that accesses the GroupWise Address Book. The Address 
Book contains information for all Novell® eDirectory™ users, Group Wise external users, 
Group Wise external entities, Group Wise e-mail distribution lists, and so on. 


gwcheck.exe file 


The gwchek.exe file is the program that checks and repairs Group Wise databases located on users’ 
workstations or other locations not accessible to the Mailbox/Library Maintenance feature of 
Console. See “GroupWise Check” in “Databases” in the GroupWise 6.5 Administration Guide. 


htrsetup.exe file 


The htrsetup.exe file is the setup program for Hit the Road, which creates your Remote mailbox. 
See “Remote Mode” in “Client” in the GroupWise 6.5 Administration Guide. 
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gwimpexe.exe file 


The gwimpexe.exe file is the GroupWise E-Mail Importer Utility, which enables you to import 

supported POP3/IMPA4 accounts into GroupWise. See “Importing POP3 and IMAP4 Accounts” 

in “Working with Items in Your Mailbox” in the GroupWise 6.5 Windows Client User Guide. 
gwmailto.exe file 


The gwmailto.exe file is the program that integrates the Group Wise client with your Web browser. 
If you select Internet Browser Mail Integration during installation, the GroupWise client becomes 
the default e-mail program on your workstation. See “Setting Up the GroupWise Client” in 
“Installing the GroupWise Windows and Cross-Platform Clients” in the GroupWise 6.5 
Installation Guide. 

gwreload.exe file 


The gwreload.exe file is the program that restarts the Group Wise client when you switch between 
Online, Caching, and Remote modes. See “Using Caching Mode” and “Using Remote Mode” in 
the GroupWise 6.5 Windows Client User Guide. 
gwsync.exe file 
The gwsync.exe file is the program that synchronizes your Online and Caching mailboxes. See 
“Using Caching Mode” in the GroupWise 6.5 Windows Client User Guide. 
ngwguard.dc file 
The ngwguard.dc file is the data dictionary for building databases in the post office. GroupWise 
Remote also uses the ngwguard.dc file as the data dictionary for its local databases. 
wprof.dc file 


The wprof.dc file is the data dictionary for the GroupWise Remote Address Book (wprof.db). 


Historical Note: An earlier version of GroupWise Remote, designed by WordPerfect Corporation 
(WPCorp), was named WP Office Remote. Hence, the wprof in wprof.dc. Some naming 
conventions were originally preserved for backward compatibility. 


* dil files 


* dll files are dynamically linked libraries of program code used by executable programs. 
Language-independent *.dll files are typically located in the same directory with the executable 
programs they support. Language-specific *.dll files are grouped into subdirectories by language. 


* ocx files 


* ocx files are OLE custom controls. For example, *.ocx files control the Address Book and name 
completion. 
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* fit files 


* flt files are graphics filters used by the Inso viewers incorporated into the GroupWise client. The 
viewers enable you to view a wide variety of file types from within GroupWise. 


* chm files 


* chm files contain the online documentation for all components of GroupWise. *.chm files are 
typically located in the same directory with the executable programs they support. 


ofviews directory 


The ofviews directory contains platform-specific subdirectories of view files for use by the 
Group Wise client. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation 
(WPCorp), was named WP Office. Hence, the of in ofviews. Some naming conventions were 
originally preserved for backward compatibility. 


win directory 


The win subdirectory contains view (*.vew) files for use by the Group Wise client. It also contains 
initialization (*.ini) files to control display of views. 


ppforms directory 
The ppforms directory contains day planner forms for printing GroupWise calendars and tasks. 


* bfp files 


* bfp files are form description files that contain binder, filler, and page attributes for forms. 


* prs files 


* prs files are print resource files that indicate which forms are available for which languages. For 
example, day planners used by English-speaking people in the United States have different forms 
from day planners used for various languages in Europe. 


Cross-Platform Client on Linux 


3 /opt/novell/groupwise/client | GroupWise Cross-Platform client installation directory 


LJ gwclient.desktop Desktop shortcut for the Cross-Platform client 

LJ gwclient.png Desktop icon for the Cross-Platform client shortcut 

a bin Subdirectory for the Cross-Platform client executable 
J groupwise Cross-Platform client executable 
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E iib 
J gwenlxxx.fil 
J ngwguard.dc 
J wprof.dc 
Ll * jar 
_] * Sô 


3 jre 


E logs 


/opt/novell/groupwise/client directory 


Subdirectory for Cross-Platform client library files 
Cross-Platform client language resource files 

Data dictionary for local databases on the user’s workstation 
Data dictionary for the local copy of the Address Book 

Java archive (.jar) files used by the Cross-Platform client 
Shared library files used by the Cross-Platform client 


Java Runtime Environment (JRE) used by the Cross-Platform 
client 


Log files generated by the Cross-Platform client 


The /opt/novell/groupwise/client directory is the default location for the GroupWise Cross- 
Platform software. The Installation program does not provide the opportunity to specify a different 
location and typically there is no need to move the software. 


gwclient.desktop file 


The gwclient.desktop file create the GroupWise Cross-Platform client shortcut on your Linux 


desktop. 


gwclient.png file 


The gwclient.png file is the GroupWise icon used for Cross-Platform client shortcut. 


bin directory 


The bin directory is the standard Linux location for executable files. 


groupwise file 


The groupwise file is the GroupWise Cross-Platform client executable. See “Starting the 
GroupWise Cross-Platform Client” in the GroupWise 6.5 Cross-Platform Client User Guide. 


lib directory 


The lib directory is the standard Linux location for library files. 


gwen|xxx.fil file 


The gwenlxxx.file provides the language-specific strings for the localized versions of the Cross- 
Platform client. The xx is a two-letter language code. 


ngwguard.dc file 


The ngwguard.dc file is the data dictionary for building the databases used by the Cross-Platform 
client. It is parallel in function to the ngwguard.dc file in the post office. 
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wprof.dc file 


The wprof.dc file is the data dictionary used to create the local copy of the Address Book that 
resides on the user’s workstation (wprof.db). 


* jar files 


The * jar files efficiently store information referenced by the Cross-Platform client. The 
gwclient.jar file contains the Cross-Platform online help information. 


* so files 


The *.so files are Linux shared library files the provide information to the Cross-Platform client 
executable. 


jre directory 


The jre directory holds the version of the Java Runtime Environment (JRE) that is required by the 
Cross-Platform client. 


logs directory 


The logs directory stores log files generated by the Cross-Platform client when an error occurs. 


Cross-Platform Client on Macintosh 


3 /Applications/GroupWise.app GroupWise Cross-Platform client installation directory 


[| Contents Standard Macintosh directory for application files 
| PkgInfo Standard Macintosh package info file 
LJ Info. plist Standard Macintosh package list file 
Es) MacOS Standard Macintosh directory for operating system files 
E Resources Standard Macintosh directory for resource files 
O GroupWise.icns Icons used by the Cross-Platform client 
E lib Subdirectory for Cross-Platform client library files 
LJ gwenlxxx.fil Data dictionary for local databases on the user's workstation 
LJ ngwguard.dc Data dictionary for the local copy of the Address Book 
J wprof.dc Cross-Platform client language information files 
E Java JRE used by the Cross-Platform client 
J * jar Java archive (.jar) files used by the Cross-Platform client 
L * dylib Dynamic libraries used by the Cross-Platform client 
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/Applications/GroupWise.app directory 


The /Applications/Group Wise.app directory contains the GroupWise Cross-Platform client on 
Macintosh. 


Contents directory 
The Contents directory is the standard location on Macintosh for all files that make up an 
application. 

MacOS directory 
The MacOS directory contains the JavaApplicationStub file that enables the Cross-Platform client 
to invoke the Java Virtual Machine (JVM) on Macintosh. 


Resources directory 


The Resources directory is the standard location on Macintosh for files that support an application. 


GroupWise.icns file 


The Group Wise.icns file contains all the images that display in the Cross-Platform client. 


lib directory 


The lib directory holds library files that provide information required by the Cross-Platform client. 


gwenIxxx.fil file 
The gwenlxxx.file provides the language-specific strings for the localized versions of the Cross- 
Platform client. The xx is a two-letter language code. 

ngwguard.dc file 
The ngwguard.dc file is the data dictionary for building the databases used by the Cross-Platform 
client. It is parallel in function to the ngwguard.dc file in the post office. 

wprof.dc file 


The wprof.dc file is the data dictionary used to create the local copy of the Address Book that 
resides on the user’s workstation (wprof.db). 


Java directory 


The Java directory holds the version of the Java Runtime Environment (JRE) that is required by 
the Cross-Platform client. 


* jar files 


The * jar files efficiently store information referenced by the Cross-Platform client. The 
gwclient.jar file contains the Cross-Platform online help information. 
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* dylib files 


The *.dylib files are dynamic library files the provide information to the Cross-Platform client 
program. 
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Documentation Updates 


This section lists updates to Troubleshooting 3: Message Flow and Directory Structure that have 
been made since the initial release of GroupWise® 6.5. The information will help you to keep 
current on documentation updates and, in some cases, software updates (such as a Support Pack 
release). 


The information is grouped according to the date when Troubleshooting 3: Message Flow and 
Directory Structure was republished. Within each dated section, the updates are listed by the names 
of the main table of contents sections. 


Troubleshooting 3: Message Flow and Directory Structure has been updated on the following 
dates: 


+ “February 28, 2005 (GroupWise 6.5 SP4)” on page 161 
+ “September 30, 2004” on page 161 

+ “September 30, 2003” on page 162 

+ “July 16, 2003 (GroupWise 6.5 SP1)” on page 162 


February 28, 2005 (GroupWise 6.5 SP4) 


Location Change 
Message Flow Diagrams 
“Message Delivery to and Updated some outdated icons. 


from the Internet” on 
page 41 


September 30, 2004 


Location Change 


Directory Structure 
Diagrams 


“WebAccess Agent Queue Added the WebAccess Agent queue directory structure. 
Directory” on page 86 


“Caching Mailbox Directory” Added the Caching mailbox directory structure. 
on page 89 
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Location 


“GroupWise Agent 


Installation (POA and MTA)” 


on page 97 


“Internet Agent Installation” 
on page 107 


“WebAccess Agent 
Installation” on page 113 


“Monitor Agent Installation” 
on page 123 


“Apache/Tomcat 
Installation” on page 127 


“Linux Software Distribution 
Directory” on page 143 


“Cross-Platform Client on 
Linux” on page 156 


“Cross-Platform Client on 
Macintosh” on page 158 


September 30, 2003 


Location 
Message Flow Diagrams 


“Message Flow Diagrams” 
on page 11 


Change 

Added the Linux agent directory structure. 

Added the Internet Agent directory structure for all platforms. 
Added the WebAccess Agent directory structure for all platforms. 


Added the Monitor Agent directory structure for Linux and Windows. 
Added the Apache and Tomcat directory structures for NetWare® and 
Linux. 

Added the Linux software distribution directory structure. 


Added the Cross-Platform client for Linux installation directory. 


Added the Cross-PLatform client for Macintosh installation directory. 


Change 


Added a missing item to the bulleted list. 


July 16, 2003 (GroupWise 6.5 SP1) 


The following sections list the updates that were made to GroupWise 6.5 Troubleshooting 3: 
Message Flow and Directory Structure: 


Location 


Directory Structure 
Diagrams 


“Post Office Directory” on 
page 64, mmddpoa.nnn, 
and wprof50.db 


Change 


Added POA log files and the downloadable system Address Book for 
Remote client users to the post office directory structure. 
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